Estas funciones requieren PocketHook 1.3. Los resultados persistentes y los adjuntos necesitan Agent Server 0.7.0 o un servidor compatible. El SDK es 0.1.3. Un webhook HTTPS básico sigue sirviendo para el chat y los envíos que esperan una respuesta directa.
Compatibilidad#
| Función | Requisito |
|---|---|
| Chat, enlaces HTTPS y respuestas con Atajos | Protocolo webhook habitual |
| Enviar mensaje sin esperar | intent-jobs-v1; no disponible en modo OpenClaw |
| Conservar el resultado hasta guardarlo en la app | result-acks-v1 y PocketHook 1.3 |
| Subir imágenes, PDF y archivos | /uploads; Agent Server anuncia uploads-v1 |
| Enlaces a apps y fotos locales | PocketHook 1.3 y la app o el permiso correspondiente |
| Apple Bridge 0.6.0 | macOS 14 o posterior; emparejamiento y permisos |
| Contenedor de Safari 1.0 | macOS 26.5 o posterior |
PocketHook requiere iOS 26.0 o posterior. Esta versión no depende de una futura Siri. El operador del servidor configura el proveedor y el modelo.
Entrega persistente#
GET /health anuncia X-PocketHook-Capabilities: intent-jobs-v1,result-acks-v1,uploads-v1. Los envíos asíncronos añaden x-pockethook-intent: 1, un x-pockethook-request-id único y x-pockethook-wait: 0. La extensión de compartir usa x-pockethook-share: 1. Un 202 confirma que el trabajo está guardado. Reutilizar el ID con otro mensaje, sesión, origen o modo silencioso produce un conflicto.
POST /intent-jobs/status recibe {"requestIds":["<id>"]} en lotes de hasta 50. Para recoger resultados, se envía al chat el mensaje configurado, por defecto fetchPendingTasks. Si no hay resultados, devuelve [{"msg":"false"}] sin llamar al modelo.
Con x-pockethook-result-acks: 1, cada paso incluye deliveryId, messageId y deliveryCount, estables entre recogidas. Tras guardar todos los pasos y deduplicar por messageId, el cliente confirma mediante POST /deliveries/ack, autenticado, con {"ids":["<delivery-uuid>"]}. Admite hasta 100 IDs. Repetir una confirmación es seguro y una confirmación antigua no descarta una ejecución posterior de un trabajo recurrente. Las instantáneas se guardan en data/jobs.db; la confirmación deja de ofrecerlas como pendientes y borrar el trabajo elimina sus instantáneas. Los clientes antiguos conservan el comportamiento previo de recogida.
La app conserva recibos locales aunque se recorte el historial. Los Atajos pendientes se ejecutan al volver a primer plano y se reclaman antes de abrirlos. Si se interrumpe ese proceso, el resultado puede ser incierto y no se repiten automáticamente. Tampoco se reejecutan automáticamente los intents o envíos compartidos que estaban ejecutándose al reiniciar el servidor. No se garantiza una ejecución exactamente una vez dentro de otra app.
Adjuntos y fotos#
POST /uploads recibe el archivo binario, su MIME y el token Bearer. Admite JPEG, PNG, GIF, WebP, PDF, texto, CSV, Markdown y JSON. El límite predeterminado es 25 MiB (UPLOADS_MAX_MB). La respuesta incluye ID y nombre de archivo; el mensaje lo referencia con [FILE:<uuid>.<ext>|<nombre>].
Descargar /uploads/<uuid>.<ext> también exige token. La app solo lo envía al endpoint de adjuntos del servidor configurado y rechaza las redirecciones de esas descargas. Los archivos caducan a los 30 días por defecto (UPLOADS_RETENTION_DAYS); la limpieza se ejecuta al arrancar y cada 12 horas. Las copias de seguridad del operador pueden tener otra retención.
Las imágenes adjuntas y el texto extraído de documentos pueden llegar al proveedor del modelo. Un enlace como pockethook://photos?latest=5 consulta la fototeca local tras activar la función en Ajustes y conceder acceso; por sí solo no sube fotos. Adjuntar una foto sí la envía al servidor.
Las respuestas admiten HTTPS y esquemas de apps. Se rechazan HTTP, tel, sms, facetime, facetime-audio, itms-services, app-prefs, javascript, data y file. Los enlaces a apps requieren un toque; las acciones de Atajos mantienen su ejecución configurada.
Instalar los complementos#
bun run apple-bridge:install
bun run apple-bridge:code
bun run apple-bridge:status
bun run safari:install
bun run safari:code
Abre cada complemento, empareja mediante el código de un solo uso y concede los permisos necesarios. El emparejamiento no sustituye los permisos del sistema. Safari se empareja por separado.
Apple Bridge 0.6.0 · Safari 1.0
Actualizar#
Haz una copia coherente de SQLite y guarda aparte .env, la configuración y el workspace. Instala las dependencias publicadas con bun install --frozen-lockfile. Se conservan los nombres de servicio y logs por instancia. La migración añade la tabla de entregas sin sustituir los trabajos existentes. Retroceder el código no restaura la base de datos.
El workspace distribuido solo contiene marcadores .gitkeep. Los datos de uso y las credenciales pertenecen a cada instalación. El dashboard y el resumen de trabajos existentes siguen necesitando restricciones de red o DASHBOARD=false; los endpoints nuevos de adjuntos y confirmaciones exigen autenticación.