From 5144822fc023858e203d8849c1b7b13927c83c9b Mon Sep 17 00:00:00 2001 From: QQ Date: Sat, 14 Nov 2026 14:51:33 +0800 Subject: [PATCH] Import packages/plugin/src/acp/method-policy.ts --- packages/plugin/src/acp/method-policy.ts | 111 +++++++++++++++++++++++ 1 file changed, 111 insertions(+) create mode 100644 packages/plugin/src/acp/method-policy.ts diff --git a/packages/plugin/src/acp/method-policy.ts b/packages/plugin/src/acp/method-policy.ts new file mode 100644 index 0000000..3806bae --- /dev/null +++ b/packages/plugin/src/acp/method-policy.ts @@ -0,0 +1,111 @@ +import { ACP_TOOL_CALL_ENDPOINTS, ACP_TOOL_STREAM_ENDPOINTS } from '@dsh-remote/protocol' +export { ACP_TOOL_CALL_ENDPOINTS, ACP_TOOL_STREAM_ENDPOINTS } from '@dsh-remote/protocol' +import { parseAcpImage } from './image-content.js' +import { z } from 'zod' +import { RpcError } from '../safe-error.js' + +const id = z.string().min(1).max(256) +const cwd = z.string().min(1).max(4096) +const mode = z.enum(['agent', 'plan', 'ask']) +const textBlock = z.object({ + type: z.literal('text'), + text: z.string().min(1).max(256 * 1024), +}).strict() + +const imageBlock = z.object({ type: z.literal('image'), mimeType: z.enum(['image/png', 'image/jpeg', 'image/webp', 'image/gif']), data: z.string().min(4).max(Math.ceil(8 * 1024 * 1024 / 3) * 4) }).strict().refine(value => { + try { parseAcpImage(value); return true } catch { return false } +}) +const promptBlock = z.union([textBlock, imageBlock]) + +export const acpToolStreamSchema = z.object({ + backend: z.enum(['cursor', 'claude', 'antigravity', 'pi', 'opencode', 'hermes']), endpoint: z.enum(ACP_TOOL_STREAM_ENDPOINTS), args: z.record(z.string(), z.unknown()), +}).strict() + +const schemas = { + 'dsh/sessionArchive': z.object({ sessionId: id.regex(/^[A-Za-z0-9_-]+$/), backend: z.literal('opencode') }).strict(), + 'dsh/toolCall': z.object({ sessionId: id, backend: z.enum(['cursor', 'claude', 'antigravity', 'pi', 'opencode', 'hermes']), + endpoint: z.enum(ACP_TOOL_CALL_ENDPOINTS), args: z.record(z.string(), z.unknown()) }).strict(), + 'dsh/sessionModels': z.object({ sessionId: id, backend: z.enum(['cursor', 'claude', 'antigravity', 'pi', 'opencode', 'hermes']) }).strict(), + 'dsh/selectModel': z.object({ sessionId: id, backend: z.enum(['cursor', 'claude', 'antigravity', 'pi', 'opencode', 'hermes']), + model: id, reasoningEffort: id.optional() }).strict(), + 'dsh/selectPermission': z.object({ sessionId: id, backend: z.enum(['cursor', 'claude', 'antigravity', 'pi', 'opencode', 'hermes']).optional(), + preset: z.enum(['workspace-write', 'danger-full-access']) }).strict(), + 'initialize': z.object({ + protocolVersion: z.number().int().positive().optional(), + backend: z.string().min(1).max(64).optional(), + clientInfo: z.object({ + name: z.string().min(1).max(128).optional(), + version: z.string().min(1).max(128).optional(), + }).strict().optional(), + }).strict(), + 'session/new': z.object({ + cwd, + backend: z.string().min(1).max(64).optional(), + mcpServers: z.array(z.unknown()).max(0).optional(), + mode: mode.optional(), + }).strict(), + 'session/load': z.object({ + sessionId: id, + backend: z.string().min(1).max(64).optional(), + }).strict(), + 'session/prompt': z.object({ + sessionId: id, + backend: z.enum(['cursor', 'antigravity', 'pi', 'claude', 'opencode', 'hermes']).optional(), + prompt: z.array(promptBlock).min(1).max(16).refine(parts => parts.filter(part => part.type === 'image').length <= 4), + }).strict(), + 'session/cancel': z.object({ + sessionId: id, + }).strict(), + 'dsh/directoryList': z.object({ + path: z.string().min(1).max(4096), + }).strict(), + 'dsh/workspaceList': z.object({ + backend: z.string().min(1).max(64).optional(), + }).strict().optional(), + 'dsh/sessionList': z.object({ + path: z.string().min(1).max(4096).or(z.literal('')), + backend: z.string().min(1).max(64).optional(), + limit: z.number().int().positive().max(100).optional(), + prewarm: z.boolean().optional(), + }).strict(), + 'dsh/sessionHistory': z.object({ + sessionId: id, + backend: z.string().min(1).max(64).optional(), + }).strict(), +} as const + +export type AllowedAcpMethod = keyof typeof schemas + +export const ACP_METHOD_ALLOWLIST = Object.freeze(Object.keys(schemas) as AllowedAcpMethod[]) + +export function parseAcpCall(method: string, params: unknown): { + method: AllowedAcpMethod + params: Record +} { + if (!Object.prototype.hasOwnProperty.call(schemas, method)) { + throw new RpcError('METHOD_NOT_ALLOWED', 'The ACP method is not allowlisted for Remote.') + } + const schema = schemas[method as AllowedAcpMethod] + const parsed = schema.safeParse(params ?? {}) + if (!parsed.success) { + throw new RpcError('INVALID_MESSAGE', 'The ACP parameters are invalid.') + } + return { method: method as AllowedAcpMethod, params: parsed.data as Record } +} + +export function sessionIdFromParams(method: AllowedAcpMethod, params: Record): string | undefined { + if ( + method === 'initialize' + || method === 'session/new' + || method === 'dsh/directoryList' + || method === 'dsh/workspaceList' + || method === 'dsh/sessionList' + || method === 'dsh/sessionHistory' + ) return undefined + if (typeof params.sessionId === 'string') return params.sessionId + return undefined +} + +export function isSessionMutation(method: AllowedAcpMethod): boolean { + return method === 'session/prompt' || method === 'session/cancel' || method === 'dsh/selectModel' || method === 'dsh/selectPermission' || method === 'dsh/toolCall' +}