Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

fix(orca): 图片参数嵌套数组自动拍平,describe 补扁平数组示例

Zhang Yunjinb6bc4dabc248
diff --git a/packages/lizi-mcps/src/__tests__/createWorkerTool.test.ts b/packages/lizi-mcps/src/__tests__/createWorkerTool.test.ts
index 0e7a31146a..df5c4cbd0f 100644
--- a/packages/lizi-mcps/src/__tests__/createWorkerTool.test.ts
+++ b/packages/lizi-mcps/src/__tests__/createWorkerTool.test.ts
@@ -85,6 +85,29 @@ describe('create_worker tool', () => {
expect(vi.mocked(createWorker).mock.calls[1]?.[0]).not.toHaveProperty('initialTaskImages');
});
+ it('flattens a one-level-nested images array instead of failing schema validation', async () => {
+ // 模型常见误传是多套一层([[/a.png],[/b.png]]); 接口要自愈而不是报参数错。
+ const { registry, createWorker } = setup();
+ const result = await registry.call('create_worker', {
+ role: 'developer', agent: 'codex', label: 'worker',
+ initial_task: 'review', images: [['/tmp/a.png'], ['/tmp/b.png']],
+ });
+ expect(result.isError).toBeFalsy();
+ expect(createWorker).toHaveBeenCalledWith(expect.objectContaining({
+ initialTaskImages: ['/tmp/a.png', '/tmp/b.png'],
+ }));
+ });
+
+ it('still rejects non-string image entries after flattening', async () => {
+ const { registry, createWorker } = setup();
+ const result = await registry.call('create_worker', {
+ role: 'developer', agent: 'codex', label: 'worker',
+ initial_task: 'review', images: [{ uri: '/tmp/a.png' }],
+ });
+ expect(result.isError).toBe(true);
+ expect(createWorker).not.toHaveBeenCalled();
+ });
+
it('describes the subagent distinction before creating a worker', () => {
const { registry } = setup();
diff --git a/packages/lizi-mcps/src/xdt-helper/create_worker.ts b/packages/lizi-mcps/src/xdt-helper/create_worker.ts
index d859677ee5..081bada858 100644
--- a/packages/lizi-mcps/src/xdt-helper/create_worker.ts
+++ b/packages/lizi-mcps/src/xdt-helper/create_worker.ts
@@ -66,6 +66,18 @@ export interface CreateWorkerDeps {
}) => Promise<CreateWorkerControlResult>;
}
+/**
+ * 图片地址列表的共享形状(send_to_worker / create_worker / create_workers 共用)。
+ * 要求扁平字符串数组;模型常见误传是多套一层([[a],[b]]),直接拍平自愈而不是报参数错。
+ */
+export const imagesListSchema = z.preprocess(
+ (value) =>
+ Array.isArray(value) && value.some((item) => Array.isArray(item))
+ ? (value as unknown[]).flat(1)
+ : value,
+ z.array(z.string().min(1)).max(8),
+);
+
/** 单个 worker 的稳定输入 schema;create_worker/create_workers 共用。 */
export const createWorkerSpecSchema = z.object({
role: z
@@ -107,11 +119,9 @@ export const createWorkerSpecSchema = z.object({
.min(1)
.optional()
.describe('可选, 创建后立即派给 worker 的第一条消息'),
- images: z
- .array(z.string().min(1))
- .max(8)
+ images: imagesListSchema
.optional()
- .describe('可选, 随 initial_task 发给 worker 的图片(png/jpeg/gif/webp, 最多 8 张); 仅本机 worker 支持, SSH 远端 worker 会拒绝; 不传 initial_task 时忽略。地址两类: (a) 用户在对话里贴的图 — 把上下文 <cindy-host-image-references> 里的 uri 原样传入; (b) Lead 自己落盘的本机绝对路径'),
+ .describe('可选, 随 initial_task 发给 worker 的图片(png/jpeg/gif/webp, 最多 8 张); 必须是扁平字符串数组, 每张图一个字符串, 如 ["cindy-media://...png"]; 仅本机 worker 支持, SSH 远端 worker 会拒绝; 不传 initial_task 时忽略。地址两类: (a) 用户在对话里贴的图 — 把上下文 <cindy-host-image-references> 里的 uri 原样传入; (b) Lead 自己落盘的本机绝对路径'),
working_dir: z.string().min(1).max(4096).refine((value) => value.trim().length > 0).optional()
.describe('可选,Worker 所在主机上已存在的绝对工作目录;省略则继承 Lead。创建前校验并绑定,失败不回退;不创建目录或 Git worktree。指定 execution_device_id 时是那台电脑上的目录,省略则由那台分配任务目录。'),
execution_device_id: z.string().trim().min(1).max(128).optional()
diff --git a/packages/lizi-mcps/src/xdt-helper/send_to_worker.ts b/packages/lizi-mcps/src/xdt-helper/send_to_worker.ts
index 8772b7369b..c6aae8bc68 100644
--- a/packages/lizi-mcps/src/xdt-helper/send_to_worker.ts
+++ b/packages/lizi-mcps/src/xdt-helper/send_to_worker.ts
@@ -10,6 +10,7 @@ import { z } from 'zod';
import type { XdtHelperToolRegistry } from '../lizi_xdtHelperToolRegistry.js';
import type { ControlResult } from '../lizi_xdtHelperMcpServer.js';
import { errorPayload, okPayload } from './_payload.js';
+import { imagesListSchema } from './create_worker.js';
/** 协同消息投递方式:queue = 普通直发/排队(缺省),steer = 尝试插进对方当前 turn。 */
export type OrcaMessageDelivery = 'queue' | 'steer';
@@ -97,11 +98,9 @@ export function registerSendToWorkerTool(
.enum(['queue', 'steer'])
.optional()
.describe('投递方式:queue(默认)= 直发或排队;steer = 尝试插进 worker 当前 turn'),
- images: z
- .array(z.string().min(1))
- .max(8)
+ images: imagesListSchema
.optional()
- .describe('可选, 随消息发给 worker 的图片(png/jpeg/gif/webp, 最多 8 张); 仅本机 worker 支持, SSH 远端 worker 会被拒绝。地址两类: (a) 用户在对话里贴的图 — 把上下文 <cindy-host-image-references> 里的 uri 原样传入; (b) Lead 自己落盘的本机绝对路径'),
+ .describe('可选, 随消息发给 worker 的图片(png/jpeg/gif/webp, 最多 8 张); 必须是扁平字符串数组, 每张图一个字符串, 如 ["cindy-media://...png"]; 仅本机 worker 支持, SSH 远端 worker 会被拒绝。地址两类: (a) 用户在对话里贴的图 — 把上下文 <cindy-host-image-references> 里的 uri 原样传入; (b) Lead 自己落盘的本机绝对路径'),
},
handler: async ({ target_session_id, message, delivery, images }) => {
const ctx = deps.getSessionContext?.();