@downcity/agent 1.1.74 → 1.1.81

package/src/index.ts

@@ -8,8 +8,10 @@
  */
 
 // Agent 入口
-export { Agent } from "./agent/Agent.js";
-export { RemoteAgent } from "./agent/RemoteAgent.js";
+export { Agent } from "./agent/local/Agent.js";
+export { RemoteAgent } from "./agent/remote/RemoteAgent.js";
+export { Session } from "./session/Session.js";
+export type { SessionOptions } from "./types/session/SessionOptions.js";
 export {
   inferAgentModelLabel,
   normalizeAgentModel,
@@ -17,8 +19,10 @@ export {
 export type {
   AgentSessionCollection,
   AgentModel,
+  AgentManagedSession,
   AgentSessionActor,
   AgentSession,
+  AgentSessionConstructor,
   AgentCreateSessionInput,
   AgentListSessionsInput,
   AgentOptions,
@@ -65,6 +69,7 @@ export type {
 
 // Plugin 作者 API
 export { BasePlugin } from "./plugin/core/BasePlugin.js";
+export { ImagePlugin } from "./plugin/core/ImagePlugin.js";
 
 // Session 与即时执行集成
 export { Executor } from "./executor/Executor.js";
@@ -73,9 +78,27 @@ export {
   getSessionRunScope,
 } from "./executor/SessionRunScope.js";
 export { JsonlSessionHistoryComposer } from "./executor/composer/history/jsonl/JsonlSessionHistoryComposer.js";
+export { LocalSessionContextComposer } from "./executor/composer/context/LocalSessionContextComposer.js";
 export { JsonlSessionHistoryStore } from "./executor/store/history/jsonl/JsonlSessionHistoryStore.js";
 export { JsonlSessionCompactionComposer } from "./executor/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
+export type {
+  SessionCompactionComposer,
+  SessionCompactionInput,
+} from "./executor/composer/compaction/SessionCompactionComposer.js";
+export type {
+  SessionContextComposer,
+  SessionContextComposeResult,
+} from "./executor/composer/context/SessionContextComposer.js";
+export type {
+  SessionHistoryComposer,
+  SessionHistoryPrepareInput,
+} from "./executor/composer/history/SessionHistoryComposer.js";
 export type { SessionSystemComposer } from "./executor/composer/system/SessionSystemComposer.js";
+export type {
+  SessionComposerFactoryContext,
+  SessionComposerInput,
+  SessionComposerOptions,
+} from "./types/session/SessionComposerOptions.js";
 export { transformPromptsIntoSystemMessages } from "./executor/composer/system/default/PromptRenderer.js";
 export {
   loadStaticSystemPrompts,
@@ -134,7 +157,7 @@ export {
 export { loadDowncityConfig } from "./config/Config.js";
 export {
   ensureRuntimeProjectReady,
-} from "./runtime/host/ProjectSetup.js";
+} from "./agent/local/ProjectSetup.js";
 export { assertProjectExecutionTarget } from "./config/ExecutionBinding.js";
 
 // 日志
@@ -144,7 +167,7 @@ export { getLogger, logger, type Logger } from "./utils/logger/Logger.js";
 export type {
   AgentPathRuntime,
   AgentPluginConfigRuntime,
-} from "./types/runtime/host/AgentHost.js";
+} from "./types/agent/AgentRuntimeAssembly.js";
 
 // 项目协议类型
 export type {
@@ -202,6 +225,16 @@ export type {
 } from "./types/runtime/http/InlineInstant.js";
 
 // Plugin 作者与控制面类型
+export type {
+  ImagePluginContent,
+  ImagePluginFileContent,
+  ImagePluginInput,
+  ImagePluginMessage,
+  ImagePluginOptions,
+  ImagePluginResult,
+  ImagePluginTextContent,
+} from "./types/plugin/ImagePlugin.js";
+
 export type {
   Plugin,
   PluginAction,
@@ -273,7 +306,7 @@ export type {
   UpsertChannelAccountInput,
   UpsertEnvEntryInput,
   UpsertGlobalEnvEntryInput,
-} from "./types/runtime/host/Store.js";
+} from "./types/platform/Store.js";
 
 // HTTP auth 协议类型
 export {

package/src/plugin/core/BasePlugin.ts

@@ -55,12 +55,12 @@ export abstract class BasePlugin implements Plugin {
   /**
    * 插件标题。
    */
-  readonly title = "";
+  readonly title: string = "";
 
   /**
    * 插件说明。
    */
-  readonly description = "";
+  readonly description: string = "";
 
   /**
    * 插件配置定义。

package/src/plugin/core/ImagePlugin.ts

@@ -0,0 +1,128 @@
+/**
+ * ImagePlugin：Agent 内置图片生成插件。
+ *
+ * 关键点（中文）
+ * - 插件只负责把外部 image 函数暴露为 agent 可调用 action。
+ * - 具体模型、Provider、鉴权与上游协议由调用方传入的 image 函数处理。
+ * - action 返回 AI SDK UIMessage，后续由 plugin tool bridge 抽取 file parts 写回 assistant 消息。
+ */
+
+import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
+import type { JsonObject, JsonValue } from "@/types/common/Json.js";
+import type {
+  ImagePluginInput,
+  ImagePluginOptions,
+  ImagePluginResult,
+} from "@/types/plugin/ImagePlugin.js";
+import { BasePlugin } from "@/plugin/core/BasePlugin.js";
+
+const DEFAULT_IMAGE_PLUGIN_NAME = "image";
+const DEFAULT_IMAGE_PLUGIN_TITLE = "Image";
+const DEFAULT_IMAGE_PLUGIN_DESCRIPTION =
+  "Generate images and return them as assistant file parts.";
+
+/**
+ * 判断值是否为普通对象。
+ */
+function to_record(value: unknown): Record<string, unknown> | null {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  return value as Record<string, unknown>;
+}
+
+/**
+ * 归一化模型传入的图片生成 payload。
+ */
+function normalize_image_payload(payload: JsonValue | undefined): ImagePluginInput {
+  const record = to_record(payload ?? {});
+  if (!record) {
+    throw new TypeError("ImagePlugin.generate payload must be an object");
+  }
+  return { ...record } as ImagePluginInput;
+}
+
+/**
+ * 校验 image 函数返回的 UIMessage。
+ */
+function normalize_image_result(result: ImagePluginResult): ImagePluginResult {
+  const record = to_record(result);
+  if (!record || !Array.isArray(record.parts)) {
+    throw new TypeError("ImagePlugin image function must return an AI SDK UIMessage");
+  }
+  return result;
+}
+
+/**
+ * Agent 图片生成插件。
+ */
+export class ImagePlugin extends BasePlugin {
+  /**
+   * 当前 plugin 稳定名称。
+   */
+  readonly name: string;
+
+  /**
+   * 插件标题。
+   */
+  readonly title: string;
+
+  /**
+   * 插件说明。
+   */
+  readonly description: string;
+
+  private readonly image: ImagePluginOptions["image"];
+
+  constructor(options: ImagePluginOptions) {
+    super();
+    const name = String(options.name || DEFAULT_IMAGE_PLUGIN_NAME).trim();
+    if (!name) {
+      throw new Error("ImagePlugin requires a non-empty name");
+    }
+    if (typeof options.image !== "function") {
+      throw new Error("ImagePlugin requires an image(input) function");
+    }
+    this.name = name;
+    this.title = String(options.title || DEFAULT_IMAGE_PLUGIN_TITLE).trim();
+    this.description = String(
+      options.description || DEFAULT_IMAGE_PLUGIN_DESCRIPTION,
+    ).trim();
+    this.image = options.image;
+  }
+
+  /**
+   * 图片插件给模型的最小使用说明。
+   */
+  system(_context: AgentContext): string {
+    return [
+      "Image generation is available through the plugin_call tool.",
+      `Call plugin "${this.name}" action "generate" when the user asks to create, render, draw, or edit an image.`,
+      "Pass a JSON payload with prompt, optional size/aspect_ratio/quality/n, and optional provider_options.",
+      "The generated image files will be attached to the final assistant message automatically.",
+    ].join("\n");
+  }
+
+  /**
+   * 显式 action 集合。
+   */
+  readonly actions = {
+    generate: {
+      execute: async ({ payload }: { payload: JsonValue }) => {
+        try {
+          const input = normalize_image_payload(payload);
+          const message = normalize_image_result(await this.image(input));
+          return {
+            success: true,
+            data: message as unknown as JsonObject,
+            message: "image generated",
+          };
+        } catch (error) {
+          return {
+            success: false,
+            error: String(error),
+            message: String(error),
+          };
+        }
+      },
+    },
+  };
+}

package/src/plugin/core/PluginCommandRequest.ts

@@ -2,7 +2,7 @@
  * PluginCommandRequest：统一 plugin runtime command 请求解析模块。
  *
  * 关键点（中文）
- * - 统一收口当前 HTTP 入口的请求体解析。
+ * - 统一收口 Town gateway command 入口的请求体解析。
  * - plugin runtime 远程调用统一走 runtime command 协议，不再让 action 自带 HTTP route。
  * - ActionSchedule 参数（`schedule` / `delay` / `time`）也在这里一次性归一化。
  */

package/src/plugin/core/PluginLocalExecution.ts

@@ -15,7 +15,7 @@ import { findPluginByName } from "@/plugin/core/PluginCatalog.js";
 import {
   createAgentPathRuntime,
   createAgentPluginConfigRuntime,
-} from "@/runtime/host/AgentHostRuntime.js";
+} from "@/agent/local/AgentRuntimeAssembly.js";
 import type { JsonValue } from "@/types/common/Json.js";
 import type {
   Plugin,

package/src/plugin/core/ProjectConfigStore.ts

@@ -10,7 +10,7 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
-import type { AgentPluginConfigRuntime } from "@/types/runtime/host/AgentHost.js";
+import type { AgentPluginConfigRuntime } from "@/types/agent/AgentRuntimeAssembly.js";
 
 type PersistableSections = {
   /**
@@ -71,7 +71,8 @@ export function readProjectPluginRecord(
  * 从项目配置读取单个 plugin 的启用态。
  *
  * 关键点（中文）
- * - 除 `auth` 外，未显式配置 `enabled: false` 时默认视为启用。
+ * - 未显式配置 `enabled: false` 时默认视为启用。
+ * - Agent 不按插件名维护“必需插件”例外，避免 Runtime 理解具体业务插件。
  * - 这样可以保持“零配置即可使用”的内建 plugin 体验。
  */
 export function readProjectPluginEnabled(params: {
@@ -86,7 +87,6 @@ export function readProjectPluginEnabled(params: {
 }): boolean {
   const normalizedPluginName = String(params.pluginName || "").trim();
   if (!normalizedPluginName) return false;
-  if (normalizedPluginName === "auth") return true;
   const current = readProjectPluginRecordFromConfig(params.config, normalizedPluginName);
   return current.enabled !== false;
 }
@@ -113,7 +113,7 @@ export async function writeProjectPluginEnabled(params: {
   context: ProjectPluginConfigCarrier;
 }): Promise<void> {
   const normalizedPluginName = String(params.pluginName || "").trim();
-  if (!normalizedPluginName || normalizedPluginName === "auth") return;
+  if (!normalizedPluginName) return;
   if (!params.context.config.plugins) {
     params.context.config.plugins = {};
   }