Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
export interface ComposerSelectionPrefix { textLength: number; atomCount: number }
export type ComposerWebMessage =
/**
* focus 只代表「编辑器现在有 DOM 焦点」,**不代表用户点了输入框**:WKWebView 在输入区
* 展开、拿到 native 焦点后会自己恢复 DOM 焦点并派发它。用户意图类动作(如「点输入框
* → 停止语音听写」)不能挂在这里,否则收起态点语音、输入框展开的瞬间就会误触发,把刚
* 开始的听写掐断(2026-07 实机日志确认)。
*/
| { type: 'ready' | 'focus' | 'blur' }
| { type: 'pong'; id: number }
| { type: 'height'; height: number }
| { type: 'change'; document: unknown; documentId?: number }
| { type: 'snapshot'; requestId: number; documentId: number; document: unknown; pendingPaste: boolean }
| { type: 'selection'; documentId: number; before: ComposerSelectionPrefix; through: ComposerSelectionPrefix }
| { type: 'paste-text-request'; requestId: string; text?: string }
| { type: 'paste-images-start'; requestId: string; count: number }
| { type: 'paste-image'; requestId: string; base64: string; mimeType: string; name: string; index: number }
| { type: 'paste-image-failed'; requestId: string; index: number };
export const MAX_PASTED_IMAGE_COUNT = 20;
export const MAX_PASTED_IMAGE_BASE64_CHARS = 40_000_000;
export const MAX_PASTED_IMAGE_NAME_CHARS = 255;
export const MAX_PASTED_TEXT_CHARS = 4_000_000;
const MAX_PASTE_REQUEST_ID_CHARS = 64;
export const SUPPORTED_PASTED_IMAGE_MIME_TYPES = [
'image/gif',
'image/heic',
'image/heif',
'image/jpeg',
'image/png',
'image/webp',
] as const;
const SUPPORTED_PASTED_IMAGE_MIME_TYPE_SET = new Set<string>(
SUPPORTED_PASTED_IMAGE_MIME_TYPES,
);
/** Parse the untrusted WebView bridge payload into the small native protocol. */
export function parseComposerWebMessage(raw: string): ComposerWebMessage | null {
try {
const value: unknown = JSON.parse(raw);
if (!value || typeof value !== 'object') return null;
const message = value as Record<string, unknown>;
if (message.type === 'pong') return isOffset(message.id) ? { type: 'pong', id: message.id } : null;
if (
message.type === 'ready'
|| message.type === 'focus'
|| message.type === 'blur'
) return { type: message.type };
if (message.type === 'height') {
return typeof message.height === 'number' && Number.isFinite(message.height)
? { type: 'height', height: message.height }
: null;
}
if (message.type === 'change') {
if (message.documentId !== undefined && !isOffset(message.documentId)) return null;
return { type: 'change', document: message.document,
...(message.documentId === undefined ? {} : { documentId: message.documentId as number }) };
}
if (message.type === 'snapshot') {
if (!isOffset(message.requestId) || !isOffset(message.documentId) || typeof message.pendingPaste !== 'boolean') return null;
return { type: 'snapshot', requestId: message.requestId, documentId: message.documentId,
document: message.document, pendingPaste: message.pendingPaste };
}
if (message.type === 'selection') {
if (!isOffset(message.documentId) || !isPrefix(message.before) || !isPrefix(message.through)) return null;
return { type: 'selection', documentId: message.documentId, before: message.before, through: message.through };
}
if (message.type === 'paste-text-request') {
if (
typeof message.requestId !== 'string'
|| message.requestId.length === 0
|| message.requestId.length > MAX_PASTE_REQUEST_ID_CHARS
|| (message.text !== undefined && (
typeof message.text !== 'string'
|| message.text.length > MAX_PASTED_TEXT_CHARS
))
) return null;
return {
type: 'paste-text-request',
requestId: message.requestId,
...(typeof message.text === 'string' ? { text: message.text } : {}),
};
}
if (message.type === 'paste-images-start') {
return isValidRequestId(message.requestId) && isBoundedImageIndex(message.count, 1)
? { type: 'paste-images-start', requestId: message.requestId, count: message.count }
: null;
}
if (message.type === 'paste-image-failed') {
return isValidRequestId(message.requestId) && isBoundedImageIndex(message.index, 0)
? { type: 'paste-image-failed', requestId: message.requestId, index: message.index }
: null;
}
if (message.type === 'paste-image') {
if (
!isValidRequestId(message.requestId)
|| typeof message.base64 !== 'string'
|| message.base64.length === 0
|| message.base64.length > MAX_PASTED_IMAGE_BASE64_CHARS
|| typeof message.mimeType !== 'string'
|| !SUPPORTED_PASTED_IMAGE_MIME_TYPE_SET.has(message.mimeType)
|| typeof message.name !== 'string'
|| message.name.length > MAX_PASTED_IMAGE_NAME_CHARS
|| !isBoundedImageIndex(message.index, 0)
) return null;
return {
type: 'paste-image',
requestId: message.requestId,
base64: message.base64,
mimeType: message.mimeType,
name: message.name,
index: message.index,
};
}
return null;
} catch {
return null;
}
}
function isOffset(value: unknown): value is number {
return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
}
function isPrefix(value: unknown): value is ComposerSelectionPrefix {
if (!value || typeof value !== 'object') return false;
const prefix = value as Record<string, unknown>;
return isOffset(prefix.textLength) && isOffset(prefix.atomCount);
}
function isValidRequestId(value: unknown): value is string {
return typeof value === 'string'
&& value.length > 0
&& value.length <= MAX_PASTE_REQUEST_ID_CHARS;
}
function isBoundedImageIndex(value: unknown, minimum: number): value is number {
return typeof value === 'number'
&& Number.isSafeInteger(value)
&& value >= minimum
&& value <= MAX_PASTED_IMAGE_COUNT;
}