diff --git a/packages/plugin/src/plugin-route-bridge.ts b/packages/plugin/src/plugin-route-bridge.ts new file mode 100644 index 0000000..8bf3dd8 --- /dev/null +++ b/packages/plugin/src/plugin-route-bridge.ts @@ -0,0 +1,99 @@ +import { MAX_SECURE_MESSAGE_BYTES } from '@dsh-remote/protocol' +import type { PluginRouteCallParams, PluginRouteCallResult } from '@dsh-remote/protocol' +import { z } from 'zod' +import type { SafeLogger } from './logging.js' +import { RpcError } from './safe-error.js' + +/** Local plugin web routes forwardable over the authenticated channel (POST only). */ +export const PLUGIN_ROUTE_ALLOWLIST = ['api/bot'] as const + +/** Reviewed DS Bot operations; new upstream operations stay local by default. */ +export const BOT_REMOTE_OPERATIONS = [ + 'state', 'models', 'efforts', 'providers', 'local-agents', + 'exchange', 'exchange-text', 'file-text', 'earlier', 'chat', 'run-stats', 'thinking', 'usage', 'room-progress', 'group-rows', + 'schedules', 'schedule-create', 'schedule-delete', + 'memory-view', 'memory-history', 'memory-ask', 'memory-forget', 'memory-restore', + 'folders', 'folder-list', 'team-workspace', 'set-prefs', + 'browser-takeover', 'browser-give-back', 'browser-stop', + 'create-bot', 'duplicate-bot', 'update-bot', 'delete-bot', 'set-main', 'set-flags', 'resume', 'bot-new-part', 'bot-open-part', + 'create-room', 'update-room', 'delete-room', 'stop-room-work', 'goal-draft', 'goal-control', + 'add-agent', 'agent-session', 'agent-adopt', 'agent-archive', 'agent-rename', 'remove-agent', + 'send', 'btw', 'btw-cancel', 'btw-delete', 'side-new', 'side-ask', 'side-cancel', 'side-close', + 'room-continue', 'answer-question', 'dismiss-question', 'dismiss-view', 'view-reply', 'approval-answer', 'stop-member-work', +] as const + +export function isAllowedPluginRoute(route: string): route is typeof PLUGIN_ROUTE_ALLOWLIST[number] { + return PLUGIN_ROUTE_ALLOWLIST.some(allowed => allowed === route) +} + +export type PluginRouteDispatcher = ( + route: string, + body: unknown, + signal: AbortSignal, +) => Promise<{ status: number; json: unknown }> + +const callSchema = z.object({ + route: z.enum(PLUGIN_ROUTE_ALLOWLIST), + body: z.object({ + endpoint: z.enum(BOT_REMOTE_OPERATIONS), + payload: z.record(z.string(), z.unknown()).nullable().optional(), + }).strict().superRefine((body, ctx) => { + if (body.endpoint === 'approval-answer' && body.payload?.choice !== 'allow' && body.payload?.choice !== 'reject') { + ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Only one-time approval or rejection is supported.' }) + } + }), +}).strict() + +/** Local plugin route call timeout, mirroring the Harness API bridge budget. */ +const PLUGIN_ROUTE_TIMEOUT_MS = 30_000 + +/** + * Forwards bounded POST calls to local plugin web routes (first case: ds-bot's + * `api/bot`) through the shared fetch handler of the Host connection service. + * The route allowlist and both size bounds keep the tunnel fail-closed. + */ +export class PluginRouteBridge { + constructor( + private readonly dispatch: PluginRouteDispatcher, + private readonly logger?: SafeLogger, + ) {} + + async call(input: unknown): Promise { + let params: PluginRouteCallParams + try { + params = callSchema.parse(input) as PluginRouteCallParams + } catch (error) { + if (error instanceof z.ZodError) { + throw new RpcError('INVALID_MESSAGE', 'The plugin route call is invalid for the remote channel.') + } + throw error + } + if (serializedBytes(params) > MAX_SECURE_MESSAGE_BYTES) { + throw new RpcError('INVALID_MESSAGE', `The plugin route call exceeds the ${MAX_SECURE_MESSAGE_BYTES}-byte remote limit.`) + } + const startedAt = performance.now() + let result: { status: number; json: unknown } + try { + result = await this.dispatch(params.route, params.body, AbortSignal.timeout(PLUGIN_ROUTE_TIMEOUT_MS)) + } catch (error) { + this.logger?.warn('plugin route call failed', { + route: params.route, + durationMs: Math.round(performance.now() - startedAt), + }) + throw error + } + if (serializedBytes(result) > MAX_SECURE_MESSAGE_BYTES) { + throw new RpcError('RESPONSE_TOO_LARGE', 'The plugin route response exceeds the bounded remote limit.') + } + this.logger?.debug('plugin route call ok', { + route: params.route, + status: result.status, + durationMs: Math.round(performance.now() - startedAt), + }) + return { status: result.status, json: result.json } + } +} + +function serializedBytes(value: unknown): number { + return new TextEncoder().encode(JSON.stringify(value)).byteLength +}