@vox-ai-app/integrations 1.0.0 → 1.0.1

package/README.md

@@ -1,4 +1,4 @@
-# @vox-ai-app/vox-integrations
+# @vox-ai-app/integrations
 
 macOS system integrations for Vox: Apple Mail, Screen control, and iMessage. Each integration ships with tool implementations and LLM tool definitions.
 
@@ -7,35 +7,30 @@ Requires macOS. Each integration needs specific system permissions granted by th
 ## Install
 
 ```sh
-npm install @vox-ai-app/vox-integrations
+npm install @vox-ai-app/integrations
 ```
 
 Peer dependency: `electron >= 28`
 
 ## Exports
 
-| Export                                        | Contents                      |
-| --------------------------------------------- | ----------------------------- |
-| `@vox-ai-app/vox-integrations`                | All exports                   |
-| `@vox-ai-app/vox-integrations/defs`           | All tool definitions          |
-| `@vox-ai-app/vox-integrations/mail`           | Mail functions                |
-| `@vox-ai-app/vox-integrations/screen`         | Screen capture + control      |
-| `@vox-ai-app/vox-integrations/screen/capture` | Capture only                  |
-| `@vox-ai-app/vox-integrations/screen/control` | Control only                  |
-| `@vox-ai-app/vox-integrations/screen/queue`   | Session acquire/release       |
-| `@vox-ai-app/vox-integrations/imessage`       | iMessage data, reply, service |
+| Export                                    | Contents                      |
+| ----------------------------------------- | ----------------------------- |
+| `@vox-ai-app/integrations`                | All exports                   |
+| `@vox-ai-app/integrations/defs`           | All tool definitions          |
+| `@vox-ai-app/integrations/mail`           | Mail functions                |
+| `@vox-ai-app/integrations/screen`         | Screen capture + control      |
+| `@vox-ai-app/integrations/screen/capture` | Capture only                  |
+| `@vox-ai-app/integrations/screen/control` | Control only                  |
+| `@vox-ai-app/integrations/screen/queue`   | Session acquire/release       |
+| `@vox-ai-app/integrations/imessage`       | iMessage data, reply, service |
 
 ## Mail
 
 Requires **Automation permission** for Mail (System Settings → Privacy & Security → Automation).
 
 ```js
-import {
-  sendEmail,
-  readEmails,
-  searchContacts,
-  replyToEmail
-} from '@vox-ai-app/vox-integrations/mail'
+import { sendEmail, readEmails, searchContacts, replyToEmail } from '@vox-ai-app/integrations/mail'
 
 const emails = await readEmails({ account: 'Work', folder: 'INBOX', limit: 20 })
 await sendEmail({ to: 'user@example.com', subject: 'Hi', body: 'Hello.' })
@@ -45,7 +40,7 @@ await replyToEmail({ messageId: '...', body: 'Thanks!' })
 Tool definitions:
 
 ```js
-import { MAIL_TOOL_DEFINITIONS } from '@vox-ai-app/vox-integrations/defs'
+import { MAIL_TOOL_DEFINITIONS } from '@vox-ai-app/integrations/defs'
 ```
 
 ## Screen
@@ -58,8 +53,8 @@ import {
   clickAt,
   typeText,
   getUiElements
-} from '@vox-ai-app/vox-integrations/screen'
-import { acquireScreen, releaseScreen } from '@vox-ai-app/vox-integrations/screen/queue'
+} from '@vox-ai-app/integrations/screen'
+import { acquireScreen, releaseScreen } from '@vox-ai-app/integrations/screen/queue'
 
 const session = await acquireScreen()
 try {
@@ -74,7 +69,7 @@ try {
 Tool definitions:
 
 ```js
-import { SCREEN_TOOL_DEFINITIONS } from '@vox-ai-app/vox-integrations/defs'
+import { SCREEN_TOOL_DEFINITIONS } from '@vox-ai-app/integrations/defs'
 ```
 
 ## iMessage
@@ -84,7 +79,7 @@ Requires **Full Disk Access** (System Settings → Privacy & Security → Full D
 ### Tool use (read conversations, send messages)
 
 ```js
-import { listConversations, listContacts, sendReply } from '@vox-ai-app/vox-integrations/imessage'
+import { listConversations, listContacts, sendReply } from '@vox-ai-app/integrations/imessage'
 
 const conversations = listConversations()
 const contacts = listContacts()
@@ -94,7 +89,7 @@ await sendReply('+15551234567', 'Hello from Vox!')
 ### Gateway service (AI replies to incoming iMessages)
 
 ```js
-import { createIMessageService } from '@vox-ai-app/vox-integrations/imessage'
+import { createIMessageService } from '@vox-ai-app/integrations/imessage'
 
 const svc = createIMessageService({
   logger,
@@ -117,7 +112,7 @@ svc.start('my-passphrase')
 Tool definitions:
 
 ```js
-import { IMESSAGE_TOOL_DEFINITIONS } from '@vox-ai-app/vox-integrations/defs'
+import { IMESSAGE_TOOL_DEFINITIONS } from '@vox-ai-app/integrations/defs'
 ```
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vox-ai-app/integrations",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "license": "MIT",
   "description": "macOS integrations (Mail, Screen, iMessage) for Vox",

package/src/imessage/mac/service.js

@@ -12,22 +12,6 @@ const REPLY_TIMEOUT_MS = 90_000
 const FDA_ERROR_MESSAGE =
   'Vox needs Full Disk Access to read Messages. Opening System Settings → Privacy & Security → Full Disk Access — please enable it for Vox and try again.'
 
-/**
- * Creates a self-contained iMessage watcher service.
- *
- * @param {object} opts
- * @param {(text: string, handle: string) => Promise<string|null>} opts.onMessage
- *   Called when a passphrase-matched message arrives. Must return the AI reply text (or null to skip reply).
- * @param {(text: string, handle: string) => void} [opts.onTranscript]
- *   Optional: called before onMessage, useful for emitting transcript events upstream.
- * @param {() => void} [opts.onOpenSettings]
- *   Optional: called when Full Disk Access is required. Default opens nothing.
- * @param {{ info: Function, warn: Function, error: Function }} [opts.logger]
- *   Optional: defaults to console.
- * @param {number} [opts.pollIntervalMs]
- *   Poll interval in ms. Default 3000.
- * @returns {{ start, stop, getPassphrase, listConversations, listContacts, openSettings }}
- */
 export const createIMessageService = ({
   onMessage,
   onTranscript,