@downcity/agent 1.1.207 → 1.1.210

package/src/config/DowncitySchema.ts

@@ -1,175 +0,0 @@
-/**
- * `downcity.json` Schema 定义模块。
- *
- * 职责说明（中文）
- * - 提供旧版 `downcity.json` 的 JSON Schema 常量。
- * - 保留给迁移场景与编辑器辅助，不再作为新 Agent 项目的默认配置入口。
- *
- * 边界说明（中文）
- * - 这里是静态 schema 常量，不负责运行时配置装配或业务校验逻辑。
- * - 当 schema 与运行时实现存在差异时，应同时更新配置解析与用户文档。
- */
-import type { JsonObject } from "@/types/common/Json.js";
-
-/**
- * `downcity.json` 的本地 Schema 常量。
- *
- * 关键点（中文）
- * - 该结构主要面向 legacy 文件的 IDE 校验与用户编辑体验，不替代运行时断言。
- */
-export const DOWNCITY_JSON_SCHEMA: JsonObject = {
-  $schema: "https://json-schema.org/draft/2020-12/schema",
-  $id: "https://downcity.ai/schemas/downcity.schema.json",
-  title: "Downcity downcity.json",
-  type: "object",
-  additionalProperties: true,
-  properties: {
-    $schema: {
-      type: "string",
-      description:
-        "JSON Schema reference for editor/IDE validation (e.g. ./.downcity/schema/downcity.schema.json).",
-    },
-    id: { type: "string" },
-    version: { type: "string" },
-    start: {
-      type: "object",
-      additionalProperties: true,
-      properties: {
-        port: { type: "integer", minimum: 1, maximum: 65535 },
-        host: { type: "string" },
-      },
-    },
-    execution: {
-      type: "object",
-      additionalProperties: true,
-      properties: {
-        type: {
-          type: "string",
-          enum: ["api"],
-        },
-        modelId: {
-          type: "string",
-          description:
-            "API 执行模式下绑定的 City AIService 模型 ID。",
-        },
-      },
-      required: ["type", "modelId"],
-    },
-    plugins: {
-      type: "object",
-      additionalProperties: true,
-      properties: {
-        chat: {
-          type: "object",
-          additionalProperties: true,
-          properties: {
-            queue: {
-              type: "object",
-              additionalProperties: true,
-              properties: {
-                maxConcurrency: { type: "integer", minimum: 1, maximum: 32 },
-                mergeDebounceMs: { type: "integer", minimum: 0, maximum: 60000 },
-                mergeMaxWaitMs: { type: "integer", minimum: 0, maximum: 120000 },
-              },
-            },
-            egress: {
-              type: "object",
-              additionalProperties: true,
-              properties: {
-                chatSendMaxCallsPerRun: { type: "integer", minimum: 1, maximum: 500 },
-                chatSendIdempotency: { type: "boolean" },
-              },
-            },
-            channels: {
-              type: "object",
-              additionalProperties: true,
-              description:
-                "Chat platform channels (Telegram / Feishu / QQ...).",
-              properties: {
-                telegram: {
-                  type: "object",
-                  additionalProperties: true,
-                  properties: {
-                    enabled: { type: "boolean" },
-                    channelAccountId: { type: "string" },
-                  },
-                },
-                feishu: {
-                  type: "object",
-                  additionalProperties: true,
-                  properties: {
-                    enabled: { type: "boolean" },
-                    channelAccountId: { type: "string" },
-                  },
-                },
-                qq: {
-                  type: "object",
-                  additionalProperties: true,
-                  properties: {
-                    enabled: { type: "boolean" },
-                    channelAccountId: { type: "string" },
-                  },
-                },
-              },
-            },
-          },
-        },
-      },
-    },
-    llm: {
-      type: "object",
-      additionalProperties: true,
-      properties: {
-        providers: {
-          type: "object",
-          additionalProperties: {
-            type: "object",
-            additionalProperties: true,
-            properties: {
-              type: {
-                type: "string",
-                enum: [
-                  "anthropic",
-                  "openai",
-                  "deepseek",
-                  "gemini",
-                  "open-compatible",
-                  "open-responses",
-                  "moonshot-cn",
-                  "moonshot-ai",
-                  "kimi-code",
-                  "xai",
-                  "huggingface",
-                  "openrouter",
-                ],
-              },
-              baseUrl: { type: "string" },
-              apiKey: { type: "string" },
-            },
-            required: ["type"],
-          },
-        },
-        models: {
-          type: "object",
-          additionalProperties: {
-            type: "object",
-            additionalProperties: true,
-            properties: {
-              provider: { type: "string" },
-              name: { type: "string" },
-              temperature: { type: "number" },
-              maxTokens: { type: "number" },
-              topP: { type: "number" },
-              frequencyPenalty: { type: "number" },
-              presencePenalty: { type: "number" },
-              anthropicVersion: { type: "string" },
-            },
-            required: ["provider", "name"],
-          },
-        },
-        logMessages: { type: "boolean" },
-      },
-      required: ["providers", "models"],
-    },
-  },
-};

package/src/executor/composer/system/default/assets/plugin.prompt.ts

@@ -1,9 +0,0 @@
-/**
- * 自动生成文件，请勿手改。
- * 源文件：由同路径 `*.ts.txt` 生成。
- */
-
-// Source: src/executor/composer/system/default/assets/plugin.prompt.ts.txt
-const TEXT_MODULE_CONTENT = "# Plugin State\n\nYou are working in a plugin-based execution environment.\n\n## Plugin Call Rules\n\n- When you need plugin capabilities, prefer invoking the plugin action through the available tools.\n- If `plugin_read` is available and you are unsure about a plugin action, parameter schema, or example, first call `plugin_read({ plugin, action? })` to read metadata.\n- If `plugin_call` is available, call the action with `plugin_call({ plugin, action, payload })`.\n- `plugin_call.plugin` is the plugin name, for example `skill`, `task`, `memory`, or `contact`.\n- `plugin_call.action` is the action name, for example `list`, `lookup`, `create`, or `run`.\n- `plugin_call.payload` is a structured JSON payload. Pass `{}` when there are no parameters. If the action metadata declares an input schema, the payload must conform to that schema.\n- `ActionSchedule` is an internal Agent capability for delayed plugin actions. It is not a standalone plugin.\n\n## Available Plugin Overview\n\n- Current built-in managed plugins: `shell` / `chat` / `task` / `memory` / `contact`.\n- Current built-in local plugins: `auth` / `skill`.\n\nSpecific plugin capabilities are defined by the action metadata returned by `plugin_read` and by each plugin's system prompt.\n";
-
-export default TEXT_MODULE_CONTENT;

package/src/executor/composer/system/default/assets/plugin.prompt.ts.txt

@@ -1,20 +0,0 @@
-# Plugin State
-
-You are working in a plugin-based execution environment.
-
-## Plugin Call Rules
-
-- When you need plugin capabilities, prefer invoking the plugin action through the available tools.
-- If `plugin_read` is available and you are unsure about a plugin action, parameter schema, or example, first call `plugin_read({ plugin, action? })` to read metadata.
-- If `plugin_call` is available, call the action with `plugin_call({ plugin, action, payload })`.
-- `plugin_call.plugin` is the plugin name, for example `skill`, `task`, `memory`, or `contact`.
-- `plugin_call.action` is the action name, for example `list`, `lookup`, `create`, or `run`.
-- `plugin_call.payload` is a structured JSON payload. Pass `{}` when there are no parameters. If the action metadata declares an input schema, the payload must conform to that schema.
-- `ActionSchedule` is an internal Agent capability for delayed plugin actions. It is not a standalone plugin.
-
-## Available Plugin Overview
-
-- Current built-in managed plugins: `shell` / `chat` / `task` / `memory` / `contact`.
-- Current built-in local plugins: `auth` / `skill`.
-
-Specific plugin capabilities are defined by the action metadata returned by `plugin_read` and by each plugin's system prompt.

package/src/plugin/core/Activation.ts

@@ -1,26 +0,0 @@
-/**
- * Plugin 激活兼容工具。
- *
- * 关键点（中文）
- * - 新模型不再读取 `downcity.json.plugins.<name>.enabled`。
- * - 传入 plugin 本身就表示调用方希望它可见；Agent runtime 以注册表作为真实边界。
- * - 该函数仅为旧内部集成保留，后续应优先使用 `context.plugins.has/status`。
- */
-
-import type { Plugin } from "@/plugin/types/Plugin.js";
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
-
-/**
- * 判断当前 plugin 是否可被视为启用。
- */
-export function isPluginEnabled(params: {
-  plugin: Plugin;
-  context?: Pick<AgentContext, "plugins">;
-}): boolean {
-  const pluginName = String(params.plugin.name || "").trim();
-  if (!pluginName) return false;
-  if (params.context?.plugins) {
-    return params.context.plugins.status(pluginName)?.status === "ready";
-  }
-  return true;
-}

package/src/plugin/core/Manager.ts

@@ -1,17 +0,0 @@
-/**
- * Plugin Manager 门面模块。
- */
-
-export type {
-  PluginStateControlAction,
-  PluginStateControlResult,
-  PluginStateSnapshot,
-} from "@/plugin/types/Plugin.js";
-export {
-  controlPluginState,
-  isPluginRunning,
-  listPluginStates,
-} from "@/plugin/core/PluginStateController.js";
-export {
-  runPluginCommand,
-} from "@/plugin/core/PluginActionRunner.js";

package/src/plugin/types/Plugin.ts

@@ -1,63 +0,0 @@
-/**
- * Plugin 类型 facade。
- *
- * 关键点（中文）
- * - 保留旧的 `@/plugin/types/Plugin.js` 导入路径。
- * - 真实类型按职责拆到 `src/types/plugin/*`，避免单文件继续膨胀。
- */
-
-export type {
-  PluginState,
-  PluginStateControlAction,
-  PluginStateControlResult,
-  PluginRuntimeRecord,
-  PluginSnapshot,
-  PluginStateSnapshot,
-} from "@/types/plugin/PluginState.js";
-export type {
-  PluginCommandContext,
-  PluginCommandParams,
-  PluginCommandResult,
-  PluginLifecycle,
-} from "@/types/plugin/PluginCommand.js";
-export type {
-  PluginAction,
-  PluginActionApi,
-  PluginActionCommand,
-  PluginActionCommandInput,
-  PluginActionExample,
-  PluginActionInvokeParams,
-  PluginActionInvokePort,
-  PluginActionInvokeResult,
-  PluginActionInputSchema,
-  PluginActionMetadata,
-  PluginActionResult,
-  PluginActions,
-} from "@/types/plugin/PluginAction.js";
-export type {
-  PluginAvailability,
-  PluginConfigDefinition,
-  PluginEffectHook,
-  PluginGuardHook,
-  PluginHooks,
-  PluginPipelineHook,
-  AgentPlugins,
-  PluginActionReadView,
-  PluginResolveHook,
-  PluginResolves,
-  PluginReadView,
-  PluginView,
-} from "@/types/plugin/PluginRuntime.js";
-export type {
-  PluginSetupDefinition,
-  PluginSetupField,
-  PluginSetupFieldOption,
-  PluginUsageDefinition,
-  PluginUsageField,
-  PluginUsageFieldOption,
-} from "@/types/plugin/PluginSetup.js";
-export type {
-  PluginHttpDefinition,
-  PluginHttpRegistration,
-} from "@/types/plugin/PluginHttp.js";
-export type { Plugin } from "@/types/plugin/PluginDefinition.js";

package/src/plugin/types/PluginLifecycle.ts

@@ -1,35 +0,0 @@
-/**
- * Plugin 生命周期配置类型定义。
- *
- * 关键点（中文）
- * - Plugin 是否启用属于 city 级全局状态，不属于单个 agent 项目。
- * - 该文件只描述 city 级 lifecycle 数据，不承载 agent 局部参数。
- */
-
-/**
- * 单个 plugin 的 city 级生命周期配置。
- */
-export interface CityPluginLifecycleItem {
-  /**
-   * 当前 plugin 是否在 city 级被启用。
-   */
-  enabled: boolean;
-  /**
-   * 最近更新时间（ISO 字符串）。
-   */
-  updatedAt: string;
-}
-
-/**
- * city 级 plugin 生命周期配置映射。
- */
-export interface CityPluginLifecycleConfig {
-  /**
-   * 插件生命周期配置对象映射。
-   *
-   * 说明（中文）
-   * - key 为 plugin 稳定名称。
-   * - value 为该 plugin 的 city 级启用状态快照。
-   */
-  [pluginName: string]: CityPluginLifecycleItem | undefined;
-}

package/src/plugin/types/PluginState.ts

@@ -1,12 +0,0 @@
-/**
- * PluginState：plugin 运行状态相关共享类型导出。
- */
-
-export type {
-  PluginState,
-  PluginStateControlAction,
-  PluginStateControlResult,
-  PluginRuntimeRecord,
-  PluginSnapshot,
-  PluginStateSnapshot,
-} from "@/types/plugin/PluginState.js";

package/src/plugin/types/Plugins.ts

@@ -1,67 +0,0 @@
-/**
- * plugin 管理命令类型。
- */
-
-import type { JsonValue } from "@/types/common/Json.js";
-
-export type PluginControlAction = "status" | "unregister";
-
-/**
- * 单个 plugin 的对外状态视图。
- */
-export type PluginStateView = {
-  /** plugin 稳定名称。 */
-  name: string;
-  /** 当前注册状态。 */
-  state: "ready" | "error";
-  /** 当前注册状态。 */
-  status: "ready" | "error";
-  /** 注册时间（毫秒时间戳）。 */
-  registered_at: number;
-  /** 最近更新时间（毫秒时间戳）。 */
-  updated_at: number;
-  /** 兼容旧字段的最近一次状态更新时间。 */
-  updatedAt: number;
-  /** 最近一次错误信息。 */
-  lastError?: string;
-  /** 最近一次错误信息。 */
-  last_error?: string;
-};
-
-/**
- * plugin 状态列表响应。
- */
-export type PluginStateListResponse = {
-  success: boolean;
-  plugins?: PluginStateView[];
-  error?: string;
-};
-
-/**
- * plugin 生命周期控制响应。
- */
-export type PluginControlResponse = {
-  success: boolean;
-  plugin?: PluginStateView;
-  error?: string;
-};
-
-/**
- * plugin command/action 执行响应。
- */
-export type PluginCommandResponse = {
-  success: boolean;
-  plugin?: PluginStateView;
-  message?: string;
-  data?: JsonValue;
-  error?: string;
-};
-
-export type PluginCliBaseOptions = {
-  path?: string;
-  agent?: string;
-  host?: string;
-  port?: number;
-  token?: string;
-  json?: boolean;
-};

package/src/session/index.ts

@@ -1,57 +0,0 @@
-/**
- * Session 模块聚合入口。
- *
- * 职责说明（中文）
- * - 统一暴露 `session/` 目录下的本地 Session 实现与相关辅助能力。
- * - 让 `Session` 相关代码收敛在一个目录树中，避免实现散落在 Agent 入口模块里。
- */
-
-export { Session } from "./Session.js";
-
-export {
-  getSdkAgentDirPath,
-  getSdkAgentArchivedSessionDirPath,
-  getSdkAgentArchivedSessionMessagesDirPath,
-  getSdkAgentArchivedSessionMessagesPath,
-  getSdkAgentArchivedSessionMetaPath,
-  getSdkAgentArchivedSessionsDirPath,
-  getSdkAgentSessionArchiveDirPath,
-  getSdkAgentSessionArchiveFilePath,
-  getSdkAgentSessionDirPath,
-  getSdkAgentSessionInflightPath,
-  getSdkAgentSessionMessagesDirPath,
-  getSdkAgentSessionMessagesPath,
-  getSdkAgentSessionMetaPath,
-  getSdkAgentSessionsRootDirPath,
-  getSdkAgentsRootDirPath,
-  getSdkDowncityDirPath,
-} from "./storage/Paths.js";
-export {
-  inferModelLabel,
-  normalizeSessionTitle,
-  patchSessionModelLabel,
-  readSessionMetadata,
-  readSessionMetadataFromPath,
-  resolveSystemTimezone,
-  writeSessionMetadata,
-} from "./storage/Metadata.js";
-export {
-  ensureSessionTitle,
-} from "./SessionTitle.js";
-export {
-  persistSdkAssistantResult,
-  touchSessionMetadata,
-} from "./storage/Persistence.js";
-export {
-  createRuntimeSessionPort,
-} from "./storage/RuntimeSessionPort.js";
-export {
-  buildSessionRecordsPage,
-  buildSessionInfo,
-  listArchivedAgentSessionSummaryPage,
-  listAgentSessionSummaryPage,
-  loadSessionArchiveMessagesFromPath,
-  loadSessionMessagesFromPath,
-  resolveSessionMessagePreview,
-  toSessionTimelineEvents,
-} from "./browse/Browse.js";

package/src/types/agent/AgentTypes.ts

@@ -1,58 +0,0 @@
-/**
- * Agent 对外类型 facade。
- *
- * 关键点（中文）
- * - 保留旧的 `@/types/agent/AgentTypes.js` 导入路径。
- * - 真实类型按职责拆到 AgentOptions / RemoteAgentOptions / SessionTypes / SessionActor。
- * - 这里不承载具体字段定义，避免单文件继续膨胀。
- */
-
-export type { AgentModel } from "@/model/CityModelAdapter.js";
-export type {
-  SessionComposerFactoryContext,
-  SessionComposerInput,
-  SessionComposerOptions,
-} from "@/types/session/SessionComposerOptions.js";
-export type {
-  AgentManagedSession,
-  SessionOptions,
-} from "@/types/session/SessionOptions.js";
-export type {
-  AgentOptions,
-  AgentSessionConstructor,
-} from "@/types/agent/AgentOptions.js";
-export type { RemoteAgentOptions } from "@/types/agent/RemoteAgentOptions.js";
-export type {
-  RemoteAgentPluginActionInput,
-  RemoteAgentPluginActionResult,
-} from "@/types/agent/RemoteAgentPluginAction.js";
-export type {
-  AgentArchiveSessionInput,
-  AgentArchiveSessionsInput,
-  AgentArchiveSessionResult,
-  AgentArchiveSessionsResult,
-  AgentCleanArchiveResult,
-  AgentCreateSessionInput,
-  AgentListSessionsInput,
-  AgentSessionConfigSnapshot,
-  AgentSessionForkInput,
-  AgentSessionRecordsInput,
-  AgentSessionRecordsPage,
-  AgentSessionRecordsView,
-  AgentSessionInfo,
-  AgentSessionSetInput,
-  AgentSessionSummary,
-  AgentSessionSummaryPage,
-  AgentSessionSystemBlock,
-  AgentSessionSystemBlockSource,
-  AgentSessionSystemSessionInfo,
-  AgentSessionSystemSnapshot,
-  AgentSessionTimelineEvent,
-} from "@/types/agent/SessionTypes.js";
-export type { AgentSessionStopResult } from "@/types/sdk/AgentSessionStop.js";
-export type {
-  AgentSession,
-  AgentSessionActor,
-  AgentSessions,
-  RemoteAgentSession,
-} from "@/types/agent/SessionActor.js";

package/src/utils/logger/Format.ts

@@ -1,15 +0,0 @@
-/**
- * LLM 请求/响应日志格式化公共入口。
- *
- * 关键点（中文）
- * - 外部模块只从这里导入，内部拆分对调用方透明。
- * - `ProviderFetch` 仍然保留在 facade，避免影响 `Fetch.ts` 的类型入口。
- */
-
-export { parseFetchRequestForLog } from "./FormatRequest.js";
-export { parseFetchResponseForLog } from "./FormatResponse.js";
-
-export type ProviderFetch = (
-  input: string | URL | Request,
-  init?: RequestInit,
-) => Promise<Response>;