@downcity/city 1.1.4 → 1.1.5

package/bin/types/task/TaskRunner.d.ts

@@ -1,186 +0,0 @@
-/**
- * TaskRunner 类型定义。
- *
- * 关键点（中文）
- * - 这里集中声明 task runner 在拆分后跨模块共享的内部类型。
- * - 这些类型服务于 task 运行链路，统一归档到 `src/types/task/`。
- */
-import type { SessionHistoryComposerPort } from "@downcity/agent/types/agent/AgentContext.js";
-import type { SessionExecutor } from "@downcity/agent/types/session/SessionExecutor.js";
-import type { ShipTaskRunExecutionStatusV1, ShipTaskRunProgressPhaseV1, ShipTaskRunProgressStatusV1, ShipTaskRunResultStatusV1, ShipTaskRunStatusV1 } from "@downcity/agent/services/task/types/Task.js";
-/**
- * run-progress.json 的当前快照状态。
- */
-export type RunProgressSnapshot = {
-    /**
-     * 当前进度状态。
-     */
-    status: ShipTaskRunProgressStatusV1;
-    /**
-     * 当前进度阶段。
-     */
-    phase: ShipTaskRunProgressPhaseV1;
-    /**
-     * 当前阶段对人类可读的说明文本。
-     */
-    message: string;
-    /**
-     * 当前对话轮次。
-     */
-    round?: number;
-    /**
-     * 最大允许轮次。
-     */
-    maxRounds?: number;
-    /**
-     * 运行结束时间（毫秒时间戳）。
-     */
-    endedAt?: number;
-    /**
-     * 任务总体运行状态。
-     */
-    runStatus?: ShipTaskRunStatusV1;
-    /**
-     * 执行阶段状态。
-     */
-    executionStatus?: ShipTaskRunExecutionStatusV1;
-    /**
-     * 结果校验状态。
-     */
-    resultStatus?: ShipTaskRunResultStatusV1;
-};
-/**
- * 任务结果校验结果。
- */
-export type TaskResultValidation = {
-    /**
-     * 结果校验后的状态。
-     */
-    resultStatus: ShipTaskRunResultStatusV1;
-    /**
-     * 校验失败时的错误列表。
-     */
-    errors: string[];
-};
-/**
- * 模拟用户的判定结果。
- */
-export type UserSimulatorDecision = {
-    /**
-     * 模拟用户是否认为当前结果已满足要求。
-     */
-    satisfied: boolean;
-    /**
-     * 模拟用户给出的回复文本。
-     */
-    reply: string;
-    /**
-     * 判定理由。
-     */
-    reason: string;
-    /**
-     * 可选评分，范围通常为 0-10。
-     */
-    score?: number;
-    /**
-     * 原始输出文本快照。
-     */
-    raw: string;
-};
-/**
- * 单轮对话的落盘记录。
- */
-export type DialogueRoundRecord = {
-    /**
-     * 当前任务是否启用了 review 多轮模式。
-     */
-    reviewEnabled: boolean;
-    /**
-     * 当前轮次编号。
-     */
-    round: number;
-    /**
-     * 本轮执行器收到的 query。
-     */
-    executorQuery: string;
-    /**
-     * 本轮执行器输出文本。
-     */
-    executorOutput: string;
-    /**
-     * 本轮执行器是否通过 `chat_send` 等方式实际送达文本。
-     */
-    executorDelivered: boolean;
-    /**
-     * 执行器 assistantMessage 的调试快照。
-     */
-    executorAssistantMessageSnapshot?: string;
-    /**
-     * 本轮结果校验状态。
-     */
-    validationResultStatus: ShipTaskRunResultStatusV1;
-    /**
-     * 本轮规则校验失败项。
-     */
-    ruleErrors: string[];
-    /**
-     * 模拟用户收到的 query。
-     */
-    userSimulatorQuery?: string;
-    /**
-     * 模拟用户输出文本。
-     */
-    userSimulatorOutput?: string;
-    /**
-     * 模拟用户 assistantMessage 的调试快照。
-     */
-    userSimulatorAssistantMessageSnapshot?: string;
-    /**
-     * 模拟用户最终判定结果。
-     */
-    userSimulator: UserSimulatorDecision;
-    /**
-     * 传递给下一轮执行器的反馈文本。
-     */
-    feedbackForNextRound?: string;
-};
-/**
- * script 类型任务的执行结果。
- */
-export type ScriptExecutionResult = {
-    /**
-     * script 标准输出与标准错误合并后的文本。
-     */
-    outputText: string;
-};
-/**
- * task 运行专用的 session runtime 端口。
- *
- * 关键点（中文）
- * - task runner 不直接依赖具体 `LocalSessionExecutor` 实现。
- * - 这里暴露的是 task 场景最小可用端口：执行器 + history Composer。
- */
-export type TaskSessionRuntimePort = {
-    /**
-     * 获取指定 sessionId 对应的 Session 执行端口。
-     */
-    getExecutor(sessionId: string): SessionExecutor;
-    /**
-     * 获取指定 sessionId 对应的 SessionHistoryComposer 持久化端口。
-     */
-    getHistoryComposer(sessionId: string): SessionHistoryComposerPort;
-};
-/**
- * 从 assistant 输出中提取的文本结果。
- */
-export type ChatSendOutputPick = {
-    /**
-     * 最终提取到的文本内容。
-     */
-    text: string;
-    /**
-     * 该文本是否已经通过 chat_send 等方式送达。
-     */
-    delivered: boolean;
-};
-//# sourceMappingURL=TaskRunner.d.ts.map

package/bin/types/task/TaskRunner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TaskRunner.d.ts","sourceRoot":"","sources":["../../../src/types/task/TaskRunner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACxF,OAAO,KAAK,EACV,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,6CAA6C,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,MAAM,EAAE,2BAA2B,CAAC;IACpC;;OAEG;IACH,KAAK,EAAE,0BAA0B,CAAC;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC;;OAEG;IACH,eAAe,CAAC,EAAE,4BAA4B,CAAC;IAC/C;;OAEG;IACH,YAAY,CAAC,EAAE,yBAAyB,CAAC;CAC1C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,YAAY,EAAE,yBAAyB,CAAC;IACxC;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C;;OAEG;IACH,sBAAsB,EAAE,yBAAyB,CAAC;IAClD;;OAEG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,qCAAqC,CAAC,EAAE,MAAM,CAAC;IAC/C;;OAEG;IACH,aAAa,EAAE,qBAAqB,CAAC;IACrC;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAAC;IAChD;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,0BAA0B,CAAC;CACnE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC"}

package/bin/types/task/TaskRunner.js

@@ -1,9 +0,0 @@
-/**
- * TaskRunner 类型定义。
- *
- * 关键点（中文）
- * - 这里集中声明 task runner 在拆分后跨模块共享的内部类型。
- * - 这些类型服务于 task 运行链路，统一归档到 `src/types/task/`。
- */
-export {};
-//# sourceMappingURL=TaskRunner.js.map

package/bin/types/task/TaskRunner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TaskRunner.js","sourceRoot":"","sources":["../../../src/types/task/TaskRunner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/src/cli/AgentChat.ts

@@ -1,415 +0,0 @@
-/**
- * `city agent chat` 命令实现。
- *
- * 关键点（中文）
- * - 统一覆盖交互式持续对话与一次性消息模式，不再保留独立 `quest` 命令。
- * - 目标 agent 始终按 console registry 名称解析，不依赖当前工作目录。
- * - 默认使用独立 local-cli 主会话：`local-cli-chat-main`。
- */
-
-import { createInterface } from "node:readline/promises";
-import chalk from "chalk";
-import prompts from "prompts";
-import { callAgentTransport } from "@downcity/agent";
-import { emitCliBlock } from "./CliReporter.js";
-import {
-  createSpinner,
-  runWithSpinner,
-  shouldRenderSpinner,
-  type Spinner,
-} from "@/utils/cli/Spinner.js";
-import { printResult } from "@/utils/cli/CliOutput.js";
-import {
-  resolveProjectRootByAgentName,
-  validateAgentProjectRoot,
-} from "./ServiceCommandSupport.js";
-import { listRegisteredAgentsForCli } from "./AgentSelection.js";
-import type {
-  AgentChatCliOptions,
-  AgentChatExecutionOutcome,
-  AgentChatExecuteResponse,
-  AgentChatTransportOptions,
-} from "@/types/cli/AgentChat.js";
-import { AGENT_CHAT_DEFAULT_SESSION_ID } from "@/types/cli/AgentChat.js";
-
-const AGENT_CHAT_EXECUTE_TIMEOUT_MS = 120_000;
-function normalizeChatMessage(input: string): string {
-  return String(input || "").trim();
-}
-
-function isChatSuccess(payload: AgentChatExecuteResponse | undefined): boolean {
-  if (!payload || payload.success !== true) return false;
-  if (payload.result?.success === false) return false;
-  return true;
-}
-
-async function resolveChatTargetAgentName(inputName?: string): Promise<string | null> {
-  const explicit = String(inputName || "").trim();
-  if (explicit) return explicit;
-
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    emitCliBlock({
-      tone: "error",
-      title: "Agent name is required",
-      note: "Use `city agent chat --to <agentName>` or run this command in an interactive terminal.",
-    });
-    return null;
-  }
-
-  const runningAgents = (await listRegisteredAgentsForCli()).filter(
-    (item) => item.status === "running",
-  );
-  if (runningAgents.length === 0) {
-    emitCliBlock({
-      tone: "error",
-      title: "No running agents",
-      note: "Run `city agent start` first.",
-    });
-    return null;
-  }
-
-  const response = (await prompts({
-    type: "select",
-    name: "agentName",
-    message: "选择要聊天的 Agent",
-    choices: runningAgents.map((agent) => ({
-      title: agent.name,
-      description: agent.projectRoot,
-      value: agent.name,
-    })),
-    initial: 0,
-  })) as { agentName?: string };
-  const agentName = String(response.agentName || "").trim();
-  if (!agentName) {
-    emitCliBlock({
-      tone: "info",
-      title: "Agent chat cancelled",
-    });
-    return null;
-  }
-  return agentName;
-}
-
-function printAssistantReply(replyText: string): void {
-  const text = String(replyText || "").trim();
-  if (!text) {
-    emitCliBlock({
-      tone: "info",
-      title: "No visible reply",
-      note: "The turn completed, but no user-visible text was returned.",
-    });
-    return;
-  }
-  console.log(`\n${text}\n`);
-}
-
-function printQueuedResult(params: {
-  agentName: string;
-  payload: AgentChatExecuteResponse;
-}): void {
-  emitCliBlock({
-    tone: "info",
-    title: "Turn queued",
-    facts: [
-      {
-        label: "agent",
-        value: params.agentName,
-      },
-      ...(params.payload.result?.queueItemId
-        ? [
-            {
-              label: "queue item",
-              value: params.payload.result.queueItemId,
-            },
-          ]
-        : []),
-    ],
-  });
-}
-
-/**
- * 向目标 agent 的 Console 主会话发送一轮消息。
- */
-export async function executeAgentChatTurn(params: {
-  agentName: string;
-  message: string;
-  transport?: AgentChatTransportOptions;
-}): Promise<AgentChatExecutionOutcome> {
-  const agentName = String(params.agentName || "").trim();
-  const message = normalizeChatMessage(params.message);
-  const sessionId = AGENT_CHAT_DEFAULT_SESSION_ID;
-
-  if (!agentName) {
-    return {
-      agentName: "",
-      sessionId,
-      success: false,
-      error: "Missing target agent name.",
-    };
-  }
-
-  if (!message) {
-    return {
-      agentName,
-      sessionId,
-      success: false,
-      error: "Chat message is required.",
-    };
-  }
-
-  const resolved = await resolveProjectRootByAgentName(agentName);
-  if (!resolved.projectRoot) {
-    return {
-      agentName,
-      sessionId,
-      success: false,
-      error: resolved.error || "Failed to resolve agent project path",
-    };
-  }
-
-  const pathError = validateAgentProjectRoot(resolved.projectRoot);
-  if (pathError) {
-    return {
-      agentName,
-      projectRoot: resolved.projectRoot,
-      sessionId,
-      success: false,
-      error: pathError,
-    };
-  }
-
-  const remote = await callAgentTransport<AgentChatExecuteResponse>({
-    projectRoot: resolved.projectRoot,
-    path: `/api/dashboard/sessions/${encodeURIComponent(sessionId)}/execute`,
-    method: "POST",
-    timeoutMs: AGENT_CHAT_EXECUTE_TIMEOUT_MS,
-    host: params.transport?.host,
-    port: params.transport?.port,
-    authToken: params.transport?.token,
-    body: {
-      instructions: message,
-    },
-  });
-
-  if (!remote.success || !remote.data) {
-    return {
-      agentName,
-      projectRoot: resolved.projectRoot,
-      sessionId,
-      success: false,
-      error: remote.error || "Agent daemon unreachable or returned empty error (try `city agent restart`)",
-    };
-  }
-
-  return {
-    agentName,
-    projectRoot: resolved.projectRoot,
-    sessionId: String(remote.data.sessionId || sessionId),
-    success: isChatSuccess(remote.data),
-    payload: remote.data,
-    ...(isChatSuccess(remote.data)
-      ? {}
-      : {
-          error:
-            String(remote.data.result?.error || remote.data.error || "").trim() ||
-            "Daemon error (check `city agent status` and `city agent doctor`)",
-        }),
-  };
-}
-
-async function runOneShotChat(params: {
-  agentName: string;
-  message: string;
-  options: AgentChatCliOptions;
-}): Promise<void> {
-  const outcome = await runWithSpinner(async () => {
-    return await executeAgentChatTurn({
-      agentName: params.agentName,
-      message: params.message,
-      transport: {
-        host: params.options.host,
-        port: params.options.port,
-        token: params.options.token,
-      },
-    });
-  }, {
-    text: `${params.agentName} is replying...`,
-    disabled: params.options.json === true,
-  });
-
-  if (params.options.json === true) {
-    printResult({
-      asJson: true,
-      success: outcome.success,
-      title: "agent chat",
-      payload: {
-        agent: params.agentName,
-        ...(outcome.projectRoot ? { projectRoot: outcome.projectRoot } : {}),
-        sessionId: outcome.sessionId,
-        ...(outcome.payload?.result ? { result: outcome.payload.result } : {}),
-        ...(outcome.error ? { error: outcome.error } : {}),
-      },
-    });
-    return;
-  }
-
-  if (!outcome.success || !outcome.payload) {
-    emitCliBlock({
-      tone: "error",
-      title: "Agent chat failed",
-      facts: [
-        {
-          label: "agent",
-          value: params.agentName,
-        },
-        {
-          label: "error",
-          value: outcome.error || "Agent daemon returned empty error (check config with `city agent status`)",
-        },
-      ],
-    });
-    return;
-  }
-
-  if (outcome.payload.result?.queued === true) {
-    printQueuedResult({
-      agentName: params.agentName,
-      payload: outcome.payload,
-    });
-    return;
-  }
-
-  printAssistantReply(String(outcome.payload.result?.userVisible || ""));
-}
-
-/**
- * 启动交互式持续对话。
- */
-async function runInteractiveChat(params: {
-  agentName: string;
-  options: AgentChatCliOptions;
-}): Promise<void> {
-  const prompt = `${chalk.cyan(params.agentName)} ${chalk.dim("›")} `;
-  const helpText = [
-    `${chalk.dim("/exit, /quit  — 退出对话")}`,
-    `${chalk.dim("/clear       — 清屏")}`,
-    `${chalk.dim("/help        — 显示此帮助")}`,
-    `${chalk.dim("Ctrl+C       — 退出对话")}`,
-  ];
-
-  emitCliBlock({
-    tone: "info",
-    title: `Agent chat · ${params.agentName}`,
-    note: `Session: local-cli-chat-main · ${helpText[0].replace(chalk.dim(""), "").trim()}`,
-  });
-  console.log(helpText.join("\n"));
-
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-    terminal: true,
-  });
-
-  try {
-    while (true) {
-      const line = await rl.question(prompt);
-      const text = normalizeChatMessage(line);
-      if (!text) continue;
-      if (text === "/exit" || text === "/quit") break;
-      if (text === "/clear") {
-        console.clear();
-        continue;
-      }
-      if (text === "/help") {
-        console.log(helpText.join("\n"));
-        continue;
-      }
-
-      const outcome = await runWithSpinner(async () => {
-        return await executeAgentChatTurn({
-          agentName: params.agentName,
-          message: text,
-          transport: {
-            host: params.options.host,
-            port: params.options.port,
-            token: params.options.token,
-          },
-        });
-      }, {
-        text: `${params.agentName} is replying...`,
-      });
-
-      if (!outcome.success || !outcome.payload) {
-        emitCliBlock({
-          tone: "error",
-          title: "Agent chat failed",
-          facts: [
-            {
-              label: "agent",
-              value: params.agentName,
-            },
-            {
-              label: "error",
-              value: outcome.error || "Agent daemon returned empty error (check config with `city agent status`)",
-            },
-          ],
-        });
-        continue;
-      }
-
-      if (outcome.payload.result?.queued === true) {
-        printQueuedResult({
-          agentName: params.agentName,
-          payload: outcome.payload,
-        });
-        continue;
-      }
-
-      printAssistantReply(String(outcome.payload.result?.userVisible || ""));
-    }
-  } finally {
-    rl.close();
-  }
-  console.log(chalk.dim("Chat ended."));
-}
-
-/**
- * `city agent chat` 统一入口。
- */
-export async function chatCommand(options: AgentChatCliOptions): Promise<void> {
-  const agentName = await resolveChatTargetAgentName(options.to);
-  if (!agentName) return;
-
-  const oneShotMessage = normalizeChatMessage(String(options.message || ""));
-  if (oneShotMessage) {
-    await runOneShotChat({
-      agentName,
-      message: oneShotMessage,
-      options,
-    });
-    return;
-  }
-
-  if (options.json === true) {
-    emitCliBlock({
-      tone: "error",
-      title: "JSON mode requires --message",
-      note: "Use `city agent chat --message <text> --json` for one-shot structured output.",
-    });
-    return;
-  }
-
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    emitCliBlock({
-      tone: "error",
-      title: "Interactive terminal required",
-      note: "Use this command in a local terminal with TTY support, or pass `--message` for one-shot mode.",
-    });
-    return;
-  }
-
-  await runInteractiveChat({
-    agentName,
-    options,
-  });
-}