@downcity/agent 1.1.100 → 1.1.104

package/bin/plugin/core/ImagePlugin.d.ts

@@ -1,57 +0,0 @@
-/**
- * ImagePlugin：Agent 内置图片生成插件。
- *
- * 关键点（中文）
- * - 对 Agent 只暴露同步体验的 `generate` action。
- * - City / 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 { ImagePluginOptions } from "../../types/plugin/ImagePlugin.js";
-import { BasePlugin } from "../../plugin/core/BasePlugin.js";
-/**
- * Agent 图片生成插件。
- */
-export declare class ImagePlugin extends BasePlugin {
-    /**
-     * 当前 plugin 稳定名称。
-     */
-    readonly name: string;
-    /**
-     * 插件标题。
-     */
-    readonly title: string;
-    /**
-     * 插件说明。
-     */
-    readonly description: string;
-    private readonly image;
-    constructor(options: ImagePluginOptions);
-    /**
-     * 图片插件给模型的最小使用说明。
-     */
-    system(_context: AgentContext): string;
-    private generate_image;
-    /**
-     * 显式 action 集合。
-     */
-    readonly actions: {
-        generate: {
-            execute: ({ payload }: {
-                payload: JsonValue;
-            }) => Promise<{
-                success: boolean;
-                data: JsonObject;
-                message: string;
-                error?: undefined;
-            } | {
-                success: boolean;
-                error: string;
-                message: string;
-                data?: undefined;
-            }>;
-        };
-    };
-}
-//# sourceMappingURL=ImagePlugin.d.ts.map

package/bin/plugin/core/ImagePlugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ImagePlugin.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/ImagePlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAEV,kBAAkB,EAEnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAqCzD;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2C;gBAErD,OAAO,EAAE,kBAAkB;IAiBvC;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;YASxB,cAAc;IAI5B;;OAEG;IACH,QAAQ,CAAC,OAAO;;mCAEiB;gBAAE,OAAO,EAAE,SAAS,CAAA;aAAE;;sBAMjB,UAAU;;;;;;;;;;MAY9C;CACH"}

package/bin/plugin/core/ImagePlugin.js

@@ -1,112 +0,0 @@
-/**
- * ImagePlugin：Agent 内置图片生成插件。
- *
- * 关键点（中文）
- * - 对 Agent 只暴露同步体验的 `generate` action。
- * - City / provider 的图片能力通过单个 image 函数注入。
- * - action 返回 AI SDK UIMessage，后续由 plugin tool bridge 抽取 file parts 写回 assistant 消息。
- */
-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) {
-    if (!value || typeof value !== "object" || Array.isArray(value))
-        return null;
-    return value;
-}
-/**
- * 归一化模型传入的图片生成 payload。
- */
-function normalize_image_payload(payload) {
-    const record = to_record(payload ?? {});
-    if (!record) {
-        throw new TypeError("ImagePlugin.generate payload must be an object");
-    }
-    return { ...record };
-}
-/**
- * 校验 image 函数返回的 UIMessage。
- */
-function normalize_image_result(result) {
-    const record = to_record(result);
-    if (!record || !Array.isArray(record.parts)) {
-        throw new TypeError("ImagePlugin image provider must return an AI SDK UIMessage");
-    }
-    return result;
-}
-/**
- * Agent 图片生成插件。
- */
-export class ImagePlugin extends BasePlugin {
-    /**
-     * 当前 plugin 稳定名称。
-     */
-    name;
-    /**
-     * 插件标题。
-     */
-    title;
-    /**
-     * 插件说明。
-     */
-    description;
-    image;
-    constructor(options) {
-        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 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) {
-        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");
-    }
-    async generate_image(input) {
-        return normalize_image_result(await this.image(input));
-    }
-    /**
-     * 显式 action 集合。
-     */
-    actions = {
-        generate: {
-            execute: async ({ payload }) => {
-                try {
-                    const input = normalize_image_payload(payload);
-                    const message = await this.generate_image(input);
-                    return {
-                        success: true,
-                        data: message,
-                        message: "image generated",
-                    };
-                }
-                catch (error) {
-                    return {
-                        success: false,
-                        error: String(error),
-                        message: String(error),
-                    };
-                }
-            },
-        },
-    };
-}
-//# sourceMappingURL=ImagePlugin.js.map

package/bin/plugin/core/ImagePlugin.js.map

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

package/bin/types/plugin/ImagePlugin.d.ts

@@ -1,94 +0,0 @@
-/**
- * ImagePlugin 类型定义。
- *
- * 关键点（中文）
- * - 这里仅定义 agent 对图片能力的最低层协议，不绑定 city 或任意上游 provider。
- * - 图片生成结果使用 AI SDK UIMessage，保证 session 落盘格式与现有消息系统一致。
- * - 字段保持 JSON 可序列化，便于通过 plugin action 与 tool bridge 传递。
- */
-import type { UIMessage } from "ai";
-import type { JsonObject, JsonValue } from "../../types/common/Json.js";
-/**
- * 图片生成文本内容片段。
- */
-export interface ImagePluginTextContent {
-    /** 内容类型，固定为文本。 */
-    type: "text";
-    /** 生图提示词或上下文文本。 */
-    text: string;
-}
-/**
- * 图片生成参考图片内容片段。
- */
-export interface ImagePluginFileContent {
-    /** 内容类型，固定为图片。 */
-    type: "image";
-    /** 远程图片 URL。 */
-    url?: string;
-    /** data URL 图片内容。 */
-    data_url?: string;
-    /** 图片 MIME 类型，例如 `image/png`。 */
-    media_type?: string;
-}
-/**
- * 图片生成多模态内容片段。
- */
-export type ImagePluginContent = ImagePluginTextContent | ImagePluginFileContent;
-/**
- * 图片生成上下文消息。
- */
-export interface ImagePluginMessage {
-    /** 消息角色。 */
-    role: "system" | "user" | "assistant";
-    /** 该消息内的文本与图片内容。 */
-    content: ImagePluginContent[];
-}
-/**
- * ImagePlugin 调用输入。
- */
-export interface ImagePluginInput {
-    /** 图片模型引用。 */
-    model?: string;
-    /** 单句快捷提示词。 */
-    prompt?: string;
-    /** 多轮或多模态图片生成上下文。 */
-    messages?: ImagePluginMessage[];
-    /** 生成图片数量。 */
-    n?: number;
-    /** 生成图片数量，兼容部分上游使用的 count 命名。 */
-    count?: number;
-    /** 图片尺寸，例如 `1024x1024`。 */
-    size?: string;
-    /** 图片宽高比，例如 `1:1`。 */
-    aspect_ratio?: string;
-    /** 图片宽高比，兼容部分上游使用的 ratio 命名。 */
-    ratio?: string;
-    /** 图片质量，例如 `standard`、`hd`、`ultra`、`4k`。 */
-    quality?: string;
-    /** 随机种子。 */
-    seed?: number;
-    /** 业务侧任务 ID，用于 provider 侧幂等、追踪和恢复。 */
-    client_job_id?: string;
-    /** Provider 私有参数，例如 `{ openai: {...}, gemini: {...}, luchi: {...} }`。 */
-    provider_options?: JsonObject;
-    /** 允许外部 image 函数接收其他 JSON 可序列化参数。 */
-    [key: string]: JsonValue | ImagePluginMessage[] | undefined;
-}
-/**
- * ImagePlugin 生成结果。
- */
-export type ImagePluginResult = UIMessage;
-/**
- * ImagePlugin 构造参数。
- */
-export interface ImagePluginOptions {
-    /** Plugin 稳定名称，默认 `image`。 */
-    name?: string;
-    /** Plugin 展示标题，默认 `Image`。 */
-    title?: string;
-    /** Plugin 用途说明。 */
-    description?: string;
-    /** 图片生成函数，通常传入 `(input) => city.ai.image(input)`。 */
-    image?: (input: ImagePluginInput) => Promise<ImagePluginResult> | ImagePluginResult;
-}
-//# sourceMappingURL=ImagePlugin.d.ts.map

package/bin/types/plugin/ImagePlugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ImagePlugin.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/ImagePlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kBAAkB;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,gBAAgB;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,sBAAsB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY;IACZ,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,oBAAoB;IACpB,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAChC,cAAc;IACd,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAC9B,qCAAqC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,kBAAkB,EAAE,GAAG,SAAS,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAAC;CACrF"}

package/bin/types/plugin/ImagePlugin.js

@@ -1,10 +0,0 @@
-/**
- * ImagePlugin 类型定义。
- *
- * 关键点（中文）
- * - 这里仅定义 agent 对图片能力的最低层协议，不绑定 city 或任意上游 provider。
- * - 图片生成结果使用 AI SDK UIMessage，保证 session 落盘格式与现有消息系统一致。
- * - 字段保持 JSON 可序列化，便于通过 plugin action 与 tool bridge 传递。
- */
-export {};
-//# sourceMappingURL=ImagePlugin.js.map

package/bin/types/plugin/ImagePlugin.js.map

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

package/src/plugin/core/ImagePlugin.ts

@@ -1,132 +0,0 @@
-/**
- * ImagePlugin：Agent 内置图片生成插件。
- *
- * 关键点（中文）
- * - 对 Agent 只暴露同步体验的 `generate` action。
- * - City / 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 provider 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: NonNullable<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 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");
-  }
-
-  private async generate_image(input: ImagePluginInput): Promise<ImagePluginResult> {
-    return normalize_image_result(await this.image(input));
-  }
-
-  /**
-   * 显式 action 集合。
-   */
-  readonly actions = {
-    generate: {
-      execute: async ({ payload }: { payload: JsonValue }) => {
-        try {
-          const input = normalize_image_payload(payload);
-          const message = await this.generate_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/types/plugin/ImagePlugin.ts

@@ -1,103 +0,0 @@
-/**
- * ImagePlugin 类型定义。
- *
- * 关键点（中文）
- * - 这里仅定义 agent 对图片能力的最低层协议，不绑定 city 或任意上游 provider。
- * - 图片生成结果使用 AI SDK UIMessage，保证 session 落盘格式与现有消息系统一致。
- * - 字段保持 JSON 可序列化，便于通过 plugin action 与 tool bridge 传递。
- */
-
-import type { UIMessage } from "ai";
-import type { JsonObject, JsonValue } from "@/types/common/Json.js";
-
-/**
- * 图片生成文本内容片段。
- */
-export interface ImagePluginTextContent {
-  /** 内容类型，固定为文本。 */
-  type: "text";
-  /** 生图提示词或上下文文本。 */
-  text: string;
-}
-
-/**
- * 图片生成参考图片内容片段。
- */
-export interface ImagePluginFileContent {
-  /** 内容类型，固定为图片。 */
-  type: "image";
-  /** 远程图片 URL。 */
-  url?: string;
-  /** data URL 图片内容。 */
-  data_url?: string;
-  /** 图片 MIME 类型，例如 `image/png`。 */
-  media_type?: string;
-}
-
-/**
- * 图片生成多模态内容片段。
- */
-export type ImagePluginContent =
-  | ImagePluginTextContent
-  | ImagePluginFileContent;
-
-/**
- * 图片生成上下文消息。
- */
-export interface ImagePluginMessage {
-  /** 消息角色。 */
-  role: "system" | "user" | "assistant";
-  /** 该消息内的文本与图片内容。 */
-  content: ImagePluginContent[];
-}
-
-/**
- * ImagePlugin 调用输入。
- */
-export interface ImagePluginInput {
-  /** 图片模型引用。 */
-  model?: string;
-  /** 单句快捷提示词。 */
-  prompt?: string;
-  /** 多轮或多模态图片生成上下文。 */
-  messages?: ImagePluginMessage[];
-  /** 生成图片数量。 */
-  n?: number;
-  /** 生成图片数量，兼容部分上游使用的 count 命名。 */
-  count?: number;
-  /** 图片尺寸，例如 `1024x1024`。 */
-  size?: string;
-  /** 图片宽高比，例如 `1:1`。 */
-  aspect_ratio?: string;
-  /** 图片宽高比，兼容部分上游使用的 ratio 命名。 */
-  ratio?: string;
-  /** 图片质量，例如 `standard`、`hd`、`ultra`、`4k`。 */
-  quality?: string;
-  /** 随机种子。 */
-  seed?: number;
-  /** 业务侧任务 ID，用于 provider 侧幂等、追踪和恢复。 */
-  client_job_id?: string;
-  /** Provider 私有参数，例如 `{ openai: {...}, gemini: {...}, luchi: {...} }`。 */
-  provider_options?: JsonObject;
-  /** 允许外部 image 函数接收其他 JSON 可序列化参数。 */
-  [key: string]: JsonValue | ImagePluginMessage[] | undefined;
-}
-
-/**
- * ImagePlugin 生成结果。
- */
-export type ImagePluginResult = UIMessage;
-
-/**
- * ImagePlugin 构造参数。
- */
-export interface ImagePluginOptions {
-  /** Plugin 稳定名称，默认 `image`。 */
-  name?: string;
-  /** Plugin 展示标题，默认 `Image`。 */
-  title?: string;
-  /** Plugin 用途说明。 */
-  description?: string;
-  /** 图片生成函数，通常传入 `(input) => city.ai.image(input)`。 */
-  image?: (input: ImagePluginInput) => Promise<ImagePluginResult> | ImagePluginResult;
-}