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。

6.0 KB
Raw Blame
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;
}