@downcity/agent 1.1.287 → 1.1.310

package/bin/session/storage/Metadata.js

@@ -2,12 +2,9 @@
  * SDK Session 元数据辅助。
  *
  * 关键点（中文）
- * - 统一负责 `.downcity/agents/<agentId>/sessions/<sessionId>/messages/meta.json` 的 SDK 字段读写。
+ * - 统一负责 `.downcity/agents/<agent_id>/sessions/<session_id>/messages/meta.json` 的规范化读取。
  * - 仅处理轻量配置摘要与索引信息，不负责消息 JSONL 的读写。
  */
-import fs from "fs-extra";
-import { inferAgentModelLabel, } from "../../agent/AgentModel.js";
-import { getSdkAgentSessionMetaPath } from "../../session/storage/Paths.js";
 function normalizeModelLabel(input) {
     const label = typeof input === "string" ? input.trim() : "";
     return label || undefined;
@@ -15,14 +12,14 @@ function normalizeModelLabel(input) {
 /**
  * 归一化 session 标题。
  */
-export function normalizeSessionTitle(input) {
+export function normalize_session_title(input) {
     const title = typeof input === "string" ? input.trim() : "";
     return title || undefined;
 }
 /**
  * 读取当前系统时区。
  */
-export function resolveSystemTimezone() {
+export function resolve_system_timezone() {
     const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
     return typeof timezone === "string" && timezone.trim()
         ? timezone.trim()
@@ -46,23 +43,6 @@ function normalize_history_bytes(input) {
         ? input
         : undefined;
 }
-/**
- * 从模型实例推导轻量可读标签。
- */
-export function inferModelLabel(model) {
-    return inferAgentModelLabel(model);
-}
-/**
- * 读取当前 session 的 meta.json。
- */
-export async function readSessionMetadata(input) {
-    const filePath = getSdkAgentSessionMetaPath(input.projectRoot, input.agentId, input.sessionId);
-    return await readSessionMetadataFromPath({
-        filePath,
-        sessionId: input.sessionId,
-        agentId: input.agentId,
-    });
-}
 /**
  * 从指定路径读取 session meta.json。
  *
@@ -70,108 +50,43 @@ export async function readSessionMetadata(input) {
  * - 供归档 session 等需要脱离默认 `sessions/` 目录的场景复用。
  * - 路径本身不做校验，调用方需保证可访问。
  */
-export async function readSessionMetadataFromPath(input) {
+export async function read_session_metadata_from_path(input) {
     try {
-        const raw = (await fs.readJson(input.filePath));
-        return {
-            v: 1,
-            sessionId: input.sessionId,
-            agentId: input.agentId,
-            createdAt: typeof raw.createdAt === "number" && Number.isFinite(raw.createdAt)
-                ? raw.createdAt
-                : Date.now(),
-            timezone: normalizeTimezone(raw.timezone) || resolveSystemTimezone(),
-            updatedAt: typeof raw.updatedAt === "number" && Number.isFinite(raw.updatedAt)
-                ? raw.updatedAt
-                : 0,
-            ...(normalizeSessionTitle(raw.title)
-                ? { title: normalizeSessionTitle(raw.title) }
-                : {}),
-            ...(normalizeModelLabel(raw.modelLabel)
-                ? { modelLabel: normalizeModelLabel(raw.modelLabel) }
-                : {}),
-            ...(normalize_message_count(raw.messageCount) !== undefined
-                ? { messageCount: normalize_message_count(raw.messageCount) }
-                : {}),
-            ...(normalize_preview_text(raw.previewText)
-                ? { previewText: normalize_preview_text(raw.previewText) }
-                : {}),
-            ...(normalize_history_bytes(raw.historyBytes) !== undefined
-                ? { historyBytes: normalize_history_bytes(raw.historyBytes) }
-                : {}),
-        };
+        const raw = JSON.parse((await input.files.read_file(input.filePath)).toString("utf8"));
+        return normalize_session_metadata(raw, input.session_id, input.agent_id);
     }
     catch {
-        return {
-            v: 1,
-            sessionId: input.sessionId,
-            agentId: input.agentId,
-            createdAt: Date.now(),
-            timezone: resolveSystemTimezone(),
-            updatedAt: 0,
-        };
+        return normalize_session_metadata({}, input.session_id, input.agent_id);
     }
 }
-/**
- * 写回当前 session 的 meta.json。
- */
-export async function writeSessionMetadata(input) {
-    const filePath = getSdkAgentSessionMetaPath(input.projectRoot, input.agentId, input.sessionId);
-    await fs.ensureFile(filePath);
-    await fs.writeJson(filePath, input.meta, { spaces: 2 });
-}
-/**
- * 更新当前 session 的 SDK 配置摘要。
- */
-export async function patchSessionModelLabel(input) {
-    const current = await readSessionMetadata(input);
-    const modelLabel = inferModelLabel(input.model);
-    const next = {
-        ...current,
-        agentId: input.agentId,
-        createdAt: typeof current.createdAt === "number" ? current.createdAt : Date.now(),
-        timezone: normalizeTimezone(current.timezone) || resolveSystemTimezone(),
-        updatedAt: Date.now(),
-        ...(modelLabel
-            ? {
-                modelLabel,
-            }
+/** 将未知 Metadata 内容规范化为当前 Session 的稳定结构。 */
+export function normalize_session_metadata(raw, session_id, agent_id) {
+    return {
+        v: 1,
+        session_id: session_id,
+        agent_id: agent_id,
+        created_at: typeof raw.created_at === "number" && Number.isFinite(raw.created_at)
+            ? raw.created_at
+            : Date.now(),
+        timezone: normalizeTimezone(raw.timezone) || resolve_system_timezone(),
+        updated_at: typeof raw.updated_at === "number" && Number.isFinite(raw.updated_at)
+            ? raw.updated_at
+            : 0,
+        ...(normalize_session_title(raw.title)
+            ? { title: normalize_session_title(raw.title) }
             : {}),
-    };
-    await writeSessionMetadata({
-        ...input,
-        meta: next,
-    });
-    return next;
-}
-/** 根据 canonical Message 统计刷新当前 Session metadata。 */
-export async function touchSessionMetadata(params) {
-    const current = await readSessionMetadata({
-        projectRoot: params.projectRoot,
-        agentId: params.agentId,
-        sessionId: params.sessionId,
-    });
-    const next = {
-        ...current,
-        agentId: params.agentId,
-        createdAt: typeof current.createdAt === "number" ? current.createdAt : Date.now(),
-        updatedAt: Date.now(),
-        ...(params.sessionConfig.modelLabel
-            ? { modelLabel: params.sessionConfig.modelLabel }
+        ...(normalizeModelLabel(raw.model_label)
+            ? { model_label: normalizeModelLabel(raw.model_label) }
+            : {}),
+        ...(normalize_message_count(raw.message_count) !== undefined
+            ? { message_count: normalize_message_count(raw.message_count) }
             : {}),
-        ...(typeof params.message_count === "number"
-            ? { messageCount: params.message_count }
+        ...(normalize_preview_text(raw.preview_text)
+            ? { preview_text: normalize_preview_text(raw.preview_text) }
             : {}),
-        ...(typeof params.history_bytes === "number"
-            ? { historyBytes: params.history_bytes }
+        ...(normalize_history_bytes(raw.historyBytes) !== undefined
+            ? { historyBytes: normalize_history_bytes(raw.historyBytes) }
             : {}),
-        ...(params.preview_text ? { previewText: params.preview_text } : {}),
     };
-    await writeSessionMetadata({
-        projectRoot: params.projectRoot,
-        agentId: params.agentId,
-        sessionId: params.sessionId,
-        meta: next,
-    });
 }
 //# sourceMappingURL=Metadata.js.map

package/bin/session/storage/Metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"Metadata.js","sourceRoot":"","sources":["../../../src/session/storage/Metadata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Metadata.js","sourceRoot":"","sources":["../../../src/session/storage/Metadata.ts"],"names":[],"mappings":"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"}

package/bin/session/storage/RuntimeSessionPort.d.ts

@@ -15,15 +15,15 @@ import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js
  */
 export interface CreateRuntimeSessionPortParams {
     /**
-     * 当前 sessionId。
+     * 当前 session_id。
      */
-    sessionId: string;
+    session_id: string;
     /** 获取当前 Session 优先解析后的运行时模型实例。 */
-    getModel: SessionPort["getModel"];
+    get_model: SessionPort["get_model"];
     /**
      * 读取当前 session 底层执行端口。
      */
-    getExecutor: SessionPort["getExecutor"];
+    get_executor: SessionPort["get_executor"];
     /**
      * 追加一条新的 session prompt。
      */
@@ -47,16 +47,16 @@ export interface CreateRuntimeSessionPortParams {
     /**
      * 返回当前 session 是否正在执行。
      */
-    isExecuting: () => boolean;
+    is_executing: () => boolean;
     /** 读取当前 Session 的只读上下文快照。 */
     context: SessionPort["context"];
     /**
      * 在执行前确保当前 session 已完成初始化与宿主级配置。
      */
-    ensureReadyForExecution: () => Promise<void>;
+    ensure_ready_for_execution: () => Promise<void>;
 }
 /**
  * 创建供 plugin runtime 使用的 session 端口。
  */
-export declare function createRuntimeSessionPort(params: CreateRuntimeSessionPortParams): SessionPort;
+export declare function create_runtime_session_port(params: CreateRuntimeSessionPortParams): SessionPort;
 //# sourceMappingURL=RuntimeSessionPort.d.ts.map

package/bin/session/storage/RuntimeSessionPort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RuntimeSessionPort.d.ts","sourceRoot":"","sources":["../../../src/session/storage/RuntimeSessionPort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAClC;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IACxC;;OAEG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5E;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5C;;OAEG;IACH,SAAS,EAAE,CACT,UAAU,EAAE,yBAAyB,KAClC,0BAA0B,CAAC;IAChC;;OAEG;IACH,mBAAmB,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC;IACxD;;OAEG;IACH,wBAAwB,EAAE,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAClE;;OAEG;IACH,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,6BAA6B;IAC7B,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAChC;;OAEG;IACH,uBAAuB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,8BAA8B,GACrC,WAAW,CAyBb"}
+{"version":3,"file":"RuntimeSessionPort.d.ts","sourceRoot":"","sources":["../../../src/session/storage/RuntimeSessionPort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,SAAS,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IACpC;;OAEG;IACH,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC1C;;OAEG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5E;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5C;;OAEG;IACH,SAAS,EAAE,CACT,UAAU,EAAE,yBAAyB,KAClC,0BAA0B,CAAC;IAChC;;OAEG;IACH,mBAAmB,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC;IACxD;;OAEG;IACH,wBAAwB,EAAE,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAClE;;OAEG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,6BAA6B;IAC7B,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAChC;;OAEG;IACH,0BAA0B,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,8BAA8B,GACrC,WAAW,CAyBb"}

package/bin/session/storage/RuntimeSessionPort.js

@@ -8,18 +8,18 @@
 /**
  * 创建供 plugin runtime 使用的 session 端口。
  */
-export function createRuntimeSessionPort(params) {
+export function create_runtime_session_port(params) {
     return {
-        sessionId: params.sessionId,
-        getModel: () => params.getModel(),
-        getExecutor: () => params.getExecutor(),
+        session_id: params.session_id,
+        get_model: () => params.get_model(),
+        get_executor: () => params.get_executor(),
         context: async () => await params.context(),
         prompt: async (input) => {
-            await params.ensureReadyForExecution();
+            await params.ensure_ready_for_execution();
             return await params.prompt(input);
         },
         stop: async () => {
-            await params.ensureReadyForExecution();
+            await params.ensure_ready_for_execution();
             return await params.stop();
         },
         subscribe: (subscriber) => {
@@ -31,7 +31,7 @@ export function createRuntimeSessionPort(params) {
         append_assistant_message: async (messageParams) => {
             await params.append_assistant_message(messageParams);
         },
-        isExecuting: () => params.isExecuting(),
+        is_executing: () => params.is_executing(),
     };
 }
 //# sourceMappingURL=RuntimeSessionPort.js.map

package/bin/session/storage/RuntimeSessionPort.js.map

@@ -1 +1 @@
-{"version":3,"file":"RuntimeSessionPort.js","sourceRoot":"","sources":["../../../src/session/storage/RuntimeSessionPort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2DH;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAsC;IAEtC,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE;QACjC,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE;QACvC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE;QAC3C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACtB,MAAM,MAAM,CAAC,uBAAuB,EAAE,CAAC;YACvC,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,MAAM,CAAC,uBAAuB,EAAE,CAAC;YACvC,OAAO,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;QACD,SAAS,EAAE,CAAC,UAAU,EAAE,EAAE;YACxB,OAAO,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;QACD,mBAAmB,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;YAC3C,MAAM,MAAM,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;QAClD,CAAC;QACD,wBAAwB,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;YAChD,MAAM,MAAM,CAAC,wBAAwB,CAAC,aAAa,CAAC,CAAC;QACvD,CAAC;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE;KACxC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"RuntimeSessionPort.js","sourceRoot":"","sources":["../../../src/session/storage/RuntimeSessionPort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2DH;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAsC;IAEtC,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;QACnC,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE;QACzC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE;QAC3C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACtB,MAAM,MAAM,CAAC,0BAA0B,EAAE,CAAC;YAC1C,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,MAAM,CAAC,0BAA0B,EAAE,CAAC;YAC1C,OAAO,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;QACD,SAAS,EAAE,CAAC,UAAU,EAAE,EAAE;YACxB,OAAO,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;QACD,mBAAmB,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;YAC3C,MAAM,MAAM,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;QAClD,CAAC;QACD,wBAAwB,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;YAChD,MAAM,MAAM,CAAC,wBAAwB,CAAC,aAAa,CAAC,CAAC;QACvD,CAAC;QACD,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE;KAC1C,CAAC;AACJ,CAAC"}

package/bin/tools/ask/AskQuestionsTool.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ask_question 可选 Tool。
+ *
+ * 该 Tool 只负责把模型的结构化 Tool Call 映射到当前 Session 的 Question
+ * Interaction。Session 是交互状态和生命周期的唯一拥有者；Tool 等待 Session 返回终态，
+ * 再把用户答案作为 Tool Result 交回同一 Turn 的后续模型 Step。
+ */
+import type { AskQuestionsToolOutput } from "../../types/tools/ask/AskQuestionsTool.js";
+import type { ActionResult } from "../../types/action/ActionResult.js";
+/**
+ * 由调用方显式注册、按当前 Session Turn 上下文执行的提问 Tool。
+ *
+ * @example
+ * ```ts
+ * new Agent({
+ *   tools: {
+ *     ask_question: AskQuestionsTool,
+ *   },
+ * });
+ * ```
+ */
+export declare const AskQuestionsTool: import("ai").Tool<{
+    title: string;
+    questions: ({
+        question_id: string;
+        prompt: string;
+        response_type: "text";
+    } | {
+        question_id: string;
+        prompt: string;
+        response_type: "single_select" | "multi_select";
+        options: {
+            value: string;
+            label: string;
+            description?: string | undefined;
+        }[];
+    })[];
+}, ActionResult<AskQuestionsToolOutput>>;
+//# sourceMappingURL=AskQuestionsTool.d.ts.map

package/bin/tools/ask/AskQuestionsTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AskQuestionsTool.d.ts","sourceRoot":"","sources":["../../../src/tools/ask/AskQuestionsTool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,uCAAuC,CAAC;AAG/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;wCAsD3B,CAAC"}

package/bin/tools/ask/AskQuestionsTool.js

@@ -0,0 +1,67 @@
+/**
+ * ask_question 可选 Tool。
+ *
+ * 该 Tool 只负责把模型的结构化 Tool Call 映射到当前 Session 的 Question
+ * Interaction。Session 是交互状态和生命周期的唯一拥有者；Tool 等待 Session 返回终态，
+ * 再把用户答案作为 Tool Result 交回同一 Turn 的后续模型 Step。
+ */
+import { tool } from "ai";
+import { ask_questions_input_schema } from "./AskQuestionsToolSchemas.js";
+import { generate_id } from "../../utils/Id.js";
+/**
+ * 由调用方显式注册、按当前 Session Turn 上下文执行的提问 Tool。
+ *
+ * @example
+ * ```ts
+ * new Agent({
+ *   tools: {
+ *     ask_question: AskQuestionsTool,
+ *   },
+ * });
+ * ```
+ */
+export const AskQuestionsTool = tool({
+    description: "Ask the user one or more questions when missing information would materially change the outcome. The call waits for every answer, then returns them so you can continue the same task. Do not use it for information that can be inferred safely.",
+    inputSchema: ask_questions_input_schema,
+    execute: async (input, execution_options) => {
+        const execution_context = execution_options.experimental_context;
+        const turn_context = execution_context?.session_turn_context;
+        const interaction_port = turn_context?.interactions;
+        const turn_id = String(turn_context?.session.turn_id || "").trim();
+        const tool_call_id = String(execution_options.toolCallId || "").trim();
+        if (!interaction_port || !turn_id || !tool_call_id) {
+            throw new Error("ask_question requires an active Session tool execution context");
+        }
+        const handle = await interaction_port.request({
+            interaction_id: `interaction:${generate_id()}`,
+            turn_id,
+            kind: "question",
+            source: {
+                type: "tool",
+                tool_call_id,
+                tool_name: "ask_question",
+            },
+            title: input.title,
+            questions: input.questions,
+            created_at: Date.now(),
+        });
+        const result = await handle.result;
+        if (result.status === "cancelled") {
+            throw new Error(`ask_question was cancelled: ${result.reason}`);
+        }
+        if (result.status === "expired") {
+            throw new Error("ask_question expired before the user responded");
+        }
+        if (result.response.kind !== "question") {
+            throw new Error("ask_question received an incompatible Interaction response");
+        }
+        return {
+            output: {
+                status: "resolved",
+                answers: result.response.answers,
+            },
+            messages: [],
+        };
+    },
+});
+//# sourceMappingURL=AskQuestionsTool.js.map

package/bin/tools/ask/AskQuestionsTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AskQuestionsTool.js","sourceRoot":"","sources":["../../../src/tools/ask/AskQuestionsTool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAA6B,MAAM,IAAI,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAM1E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;IACnC,WAAW,EACT,mPAAmP;IACrP,WAAW,EAAE,0BAA0B;IACvC,OAAO,EAAE,KAAK,EACZ,KAA4B,EAC5B,iBAAuC,EACQ,EAAE;QACjD,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,oBAE/B,CAAC;QACd,MAAM,YAAY,GAAG,iBAAiB,EAAE,oBAAoB,CAAC;QAC7D,MAAM,gBAAgB,GAAG,YAAY,EAAE,YAAY,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACnE,MAAM,YAAY,GAAG,MAAM,CAAC,iBAAiB,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACvE,IAAI,CAAC,gBAAgB,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC;YAC5C,cAAc,EAAE,eAAe,WAAW,EAAE,EAAE;YAC9C,OAAO;YACP,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,YAAY;gBACZ,SAAS,EAAE,cAAc;aAC1B;YACD,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;SACvB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;QACnC,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE;gBACN,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;aACjC;YACD,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/bin/tools/ask/AskQuestionsToolSchemas.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ask_question Tool 输入 Schema。
+ *
+ * 关键点（中文）：文本问题不接受候选项；单选和多选问题必须提供至少一个候选项，
+ * 从模型输入边界消除无法渲染或无法校验的 Question Interaction。
+ */
+import { z } from "zod";
+/** ask_question Tool 的运行时输入校验 Schema。 */
+export declare const ask_questions_input_schema: z.ZodObject<{
+    title: z.ZodString;
+    questions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        question_id: z.ZodString;
+        prompt: z.ZodString;
+        response_type: z.ZodLiteral<"text">;
+    }, z.core.$strict>, z.ZodObject<{
+        question_id: z.ZodString;
+        prompt: z.ZodString;
+        response_type: z.ZodEnum<{
+            single_select: "single_select";
+            multi_select: "multi_select";
+        }>;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "response_type">>;
+}, z.core.$strict>;
+//# sourceMappingURL=AskQuestionsToolSchemas.d.ts.map

package/bin/tools/ask/AskQuestionsToolSchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AskQuestionsToolSchemas.d.ts","sourceRoot":"","sources":["../../../src/tools/ask/AskQuestionsToolSchemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkCxB,yCAAyC;AACzC,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;kBAY5B,CAAC"}

package/bin/tools/ask/AskQuestionsToolSchemas.js

@@ -0,0 +1,51 @@
+/**
+ * ask_question Tool 输入 Schema。
+ *
+ * 关键点（中文）：文本问题不接受候选项；单选和多选问题必须提供至少一个候选项，
+ * 从模型输入边界消除无法渲染或无法校验的 Question Interaction。
+ */
+import { z } from "zod";
+const option_schema = z
+    .object({
+    value: z.string().trim().min(1)
+        .describe("Stable option value returned in the answer."),
+    label: z.string().trim().min(1).describe("User-visible option label."),
+    description: z.string().trim().min(1).optional()
+        .describe("Optional explanation of this option."),
+})
+    .strict();
+const text_question_schema = z
+    .object({
+    question_id: z.string().trim().min(1)
+        .describe("Stable question identifier unique within this request."),
+    prompt: z.string().trim().min(1)
+        .describe("Complete question shown to the user."),
+    response_type: z.literal("text"),
+})
+    .strict();
+const select_question_schema = z
+    .object({
+    question_id: z.string().trim().min(1)
+        .describe("Stable question identifier unique within this request."),
+    prompt: z.string().trim().min(1)
+        .describe("Complete question shown to the user."),
+    response_type: z.enum(["single_select", "multi_select"]),
+    options: z.array(option_schema).min(1)
+        .describe("Allowed values presented to the user."),
+})
+    .strict();
+/** ask_question Tool 的运行时输入校验 Schema。 */
+export const ask_questions_input_schema = z
+    .object({
+    title: z.string().trim().min(1)
+        .describe("Short title for the question card."),
+    questions: z
+        .array(z.discriminatedUnion("response_type", [
+        text_question_schema,
+        select_question_schema,
+    ]))
+        .min(1)
+        .describe("Questions that all require an answer before execution resumes."),
+})
+    .strict();
+//# sourceMappingURL=AskQuestionsToolSchemas.js.map

package/bin/tools/ask/AskQuestionsToolSchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AskQuestionsToolSchemas.js","sourceRoot":"","sources":["../../../src/tools/ask/AskQuestionsToolSchemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,aAAa,GAAG,CAAC;KACpB,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SAC5B,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACtE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC7C,QAAQ,CAAC,sCAAsC,CAAC;CACpD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SAClC,QAAQ,CAAC,wDAAwD,CAAC;IACrE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SAC7B,QAAQ,CAAC,sCAAsC,CAAC;IACnD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CACjC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,sBAAsB,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SAClC,QAAQ,CAAC,wDAAwD,CAAC;IACrE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SAC7B,QAAQ,CAAC,sCAAsC,CAAC;IACnD,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;SACnC,QAAQ,CAAC,uCAAuC,CAAC;CACrD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,yCAAyC;AACzC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SAC5B,QAAQ,CAAC,oCAAoC,CAAC;IACjD,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,eAAe,EAAE;QAC3C,oBAAoB;QACpB,sBAAsB;KACvB,CAAC,CAAC;SACF,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,gEAAgE,CAAC;CAC9E,CAAC;KACD,MAAM,EAAE,CAAC"}

package/bin/tools/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @downcity/agent/tools — 可选 Agent Tool 的公开入口。
+ *
+ * 这里导出的 Tool 不会由 Agent 自动注册。调用方按产品需要选择 Tool，并通过
+ * `AgentOptions.tools` 显式完成组合。
+ */
+export { AskQuestionsTool } from "./ask/AskQuestionsTool.js";
+export type { AskQuestionsToolInput, AskQuestionsToolOutput, } from "../types/tools/ask/AskQuestionsTool.js";
+//# sourceMappingURL=index.d.ts.map

package/bin/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,wCAAwC,CAAC"}

package/bin/tools/index.js

@@ -0,0 +1,8 @@
+/**
+ * @downcity/agent/tools — 可选 Agent Tool 的公开入口。
+ *
+ * 这里导出的 Tool 不会由 Agent 自动注册。调用方按产品需要选择 Tool，并通过
+ * `AgentOptions.tools` 显式完成组合。
+ */
+export { AskQuestionsTool } from "./ask/AskQuestionsTool.js";
+//# sourceMappingURL=index.js.map

package/bin/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/bin/types/action/ActionResult.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Action 与 Session Tool 共用的执行结果协议。
+ *
+ * 关键点（中文）
+ * - `output` 是标准 Tool Result，原样交给 AI SDK 和 canonical Tool Part。
+ * - `messages` 是执行后写入 Session 的真实 User / Assistant Message 内容。
+ * - Message Parts 直接复用 AI SDK UIMessage 协议，不再建立文件、图片或 Plugin 专用桥接。
+ */
+import type { UIMessage } from "ai";
+/** Action 执行后产生的一条 Session 消息。 */
+export interface ActionResultMessage {
+    /** 消息归属；User 消息在下一 Step 生效，Assistant Parts 写入当前回复。 */
+    role: "user" | "assistant";
+    /** 应写入对应 Session Message 的标准 UI Parts。 */
+    parts: UIMessage["parts"];
+}
+/** Action 或 Tool 内部实现返回的统一结果。 */
+export interface ActionResult<TOutput = unknown> {
+    /** 返回给调用方、AI SDK 与 canonical Tool Part 的标准执行输出。 */
+    output: TOutput;
+    /** 执行产生的真实 Session 消息；没有附加消息时传入空数组。 */
+    messages: ActionResultMessage[];
+}
+/** 判断未知 Tool 输出是否使用统一 ActionResult 协议。 */
+export declare function is_action_result(value: unknown): value is ActionResult;
+//# sourceMappingURL=ActionResult.d.ts.map

package/bin/types/action/ActionResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionResult.d.ts","sourceRoot":"","sources":["../../../src/types/action/ActionResult.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAE3B,0CAA0C;IAC1C,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;CAC3B;AAED,iCAAiC;AACjC,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,OAAO;IAC7C,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAC;IAEhB,uCAAuC;IACvC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAKtE"}

package/bin/types/action/ActionResult.js

@@ -0,0 +1,17 @@
+/**
+ * Action 与 Session Tool 共用的执行结果协议。
+ *
+ * 关键点（中文）
+ * - `output` 是标准 Tool Result，原样交给 AI SDK 和 canonical Tool Part。
+ * - `messages` 是执行后写入 Session 的真实 User / Assistant Message 内容。
+ * - Message Parts 直接复用 AI SDK UIMessage 协议，不再建立文件、图片或 Plugin 专用桥接。
+ */
+/** 判断未知 Tool 输出是否使用统一 ActionResult 协议。 */
+export function is_action_result(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const record = value;
+    return Object.prototype.hasOwnProperty.call(record, "output") &&
+        Array.isArray(record.messages);
+}
+//# sourceMappingURL=ActionResult.js.map

package/bin/types/action/ActionResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionResult.js","sourceRoot":"","sources":["../../../src/types/action/ActionResult.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsBH,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC3D,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC"}