OIP system: Phone / iMessage
A generated article for one OIP shelf. It lists every operation in this API/CLI/MCP/device/model/core subsystem, links each leaf article, and gives the ledger path for proof.
This page is the operating article for one build subsystem. It is generated from live directory rows. If a task belongs to this subsystem, scan the operations below, open the matching capability article, run only the exact object named there, and verify by receipt.
Kind: device. Capabilities: 22. Machine system map: /api/dispatch?map=PHONE&format=markdown. Root: /a/oip.
Operations
PHONE_NOTIFY
send a push to the owner's phone via iMessage. Use when: an agent finished a task, hit a milestone, or needs eyes on something. Arguments: title|body. Multi-line body OK.. Human article: /a/oip-capability-phone-notify. Machine doc: ?key=PHONE_NOTIFY&format=markdown. Invocation history: /api/invocations?object_id=PHONE_NOTIFY.
PHONE_APPROVAL_CREATE
insert a row into approvals (status=pending) and notify the owner's phone. Use when: about to do something destructive (deploy, send outreach, delete, pay) — pause first. Arguments: action|summary|resume_key|resume_body. resume_key + body are dispatched on approve.. Human article: /a/oip-capability-phone-approval-create. Machine doc: ?key=PHONE_APPROVAL_CREATE&format=markdown. Invocation history: /api/invocations?object_id=PHONE_APPROVAL_CREATE.
PHONE_APPROVAL_RESOLVE
update approvals.status to approved/denied and, on approve, dispatch the stored resume_key. Use when: phone tap, /admin/approvals click, or natural-language "approve 12". Arguments: approval_id|decision (approve|deny).. Human article: /a/oip-capability-phone-approval-resolve. Machine doc: ?key=PHONE_APPROVAL_RESOLVE&format=markdown. Invocation history: /api/invocations?object_id=PHONE_APPROVAL_RESOLVE.
PHONE_VOICE_NOTE_HANDLE
transcribe a phone voice memo and route the transcript through ROUTER like an iMessage. Use when: /api/phone/in receives action=voice_note from an iOS Shortcut. Arguments: voice_url.. Human article: /a/oip-capability-phone-voice-note-handle. Machine doc: ?key=PHONE_VOICE_NOTE_HANDLE&format=markdown. Invocation history: /api/invocations?object_id=PHONE_VOICE_NOTE_HANDLE.
PHONE_SHARE_URL_HANDLE
phone shared a URL via the Share Sheet — fetch its markdown and route to ROUTER as a normal turn. Use when: /api/phone/in receives action=share_url. Arguments: text|url.. Human article: /a/oip-capability-phone-share-url-handle. Machine doc: ?key=PHONE_SHARE_URL_HANDLE&format=markdown. Invocation history: /api/invocations?object_id=PHONE_SHARE_URL_HANDLE.
PHONE_SHARE_TEXT_HANDLE
phone shared selected text — route straight to ROUTER as if the owner had typed it. Use when: /api/phone/in action=share_text. Arguments: text.. Human article: /a/oip-capability-phone-share-text-handle. Machine doc: ?key=PHONE_SHARE_TEXT_HANDLE&format=markdown. Invocation history: /api/invocations?object_id=PHONE_SHARE_TEXT_HANDLE.
PHONE_SHARE_IMAGE_HANDLE
phone shared an image — store as reference + route image URL through ROUTER (ARCADS picks it up). Use when: /api/phone/in action=share_image or action=photo. Arguments: image_url|caption.. Human article: /a/oip-capability-phone-share-image-handle. Machine doc: ?key=PHONE_SHARE_IMAGE_HANDLE&format=markdown. Invocation history: /api/invocations?object_id=PHONE_SHARE_IMAGE_HANDLE.
PHONE_CLIPBOARD_HANDLE
phone clipboard contents → ROUTER. Same shape as share_text but explicitly tagged. Use when: /api/phone/in action=clipboard. Arguments: clipboard_text.. Human article: /a/oip-capability-phone-clipboard-handle. Machine doc: ?key=PHONE_CLIPBOARD_HANDLE&format=markdown. Invocation history: /api/invocations?object_id=PHONE_CLIPBOARD_HANDLE.
PHONE_LOCATION_HANDLE
phone location event → ROUTER. ARGS: location_label (e.g. "arrived: home"). Use when: /api/phone/in action=location, NFC tap, geofence trigger. Arguments: location_label.. Human article: /a/oip-capability-phone-location-handle. Machine doc: ?key=PHONE_LOCATION_HANDLE&format=markdown. Invocation history: /api/invocations?object_id=PHONE_LOCATION_HANDLE.
PHONE_EVENTS_TAIL
tail the phone_events table. ARGS: limit (default 20). Use when: "what did my phone send today". Human article: /a/oip-capability-phone-events-tail. Machine doc: ?key=PHONE_EVENTS_TAIL&format=markdown. Invocation history: /api/invocations?object_id=PHONE_EVENTS_TAIL.
PHONE_CAMERA
Run the Take Photo Shortcut. Arguments: none. Human article: /a/oip-capability-phone-camera. Machine doc: ?key=PHONE_CAMERA&format=markdown. Invocation history: /api/invocations?object_id=PHONE_CAMERA.
PHONE_TOOLS
Everything the owner's iPhone can now do as an API, captured by the personal-world recorder and projected through the capability ledger. Use when: to see or use the phone's recorded app calls as callable capabilities. Arguments: none.. Human article: /a/oip-capability-phone-tools. Machine doc: ?key=PHONE_TOOLS&format=markdown. Invocation history: /api/invocations?object_id=PHONE_TOOLS.
PHONE_REPLAY
Replay any capability the phone recorder captured, by its dcap id, using the phone's own session — no phone in the loop. Observe→act→observe→verify→receipt. Use when: call a recorded iPhone app endpoint from the build, a flow, a sheet or a schedule. Arguments: $1 = the dcap capability id (from PHONE_TOOLS).. Human article: /a/oip-capability-phone-replay. Machine doc: ?key=PHONE_REPLAY&format=markdown. Invocation history: /api/invocations?object_id=PHONE_REPLAY.
PHONE_DEVICES
List the iOS devices attached to the Mac over USB, with model, state and identifier. Use when: before any other PHONE_ call, or to check whether the phone is reachable at all. Arguments: none. Human article: /a/oip-capability-phone-devices. Machine doc: ?key=PHONE_DEVICES&format=markdown. Invocation history: /api/invocations?object_id=PHONE_DEVICES.
PHONE_INFO
Full details of the connected iPhone: model, iOS version, capacity, developer mode state. Use when: identifying the device or confirming developer mode is on. Arguments: none. Human article: /a/oip-capability-phone-info. Machine doc: ?key=PHONE_INFO&format=markdown. Invocation history: /api/invocations?object_id=PHONE_INFO.
PHONE_APPS
Every app installed on the connected iPhone with its bundle id and version. Use when: finding the bundle id to launch, or auditing what is on the device. Arguments: none. Human article: /a/oip-capability-phone-apps. Machine doc: ?key=PHONE_APPS&format=markdown. Invocation history: /api/invocations?object_id=PHONE_APPS.
PHONE_DISPLAYS
The iPhone's current display geometry and scale. Use when: converting a coordinate on a captured frame into a real device point. Arguments: none. Human article: /a/oip-capability-phone-displays. Machine doc: ?key=PHONE_DISPLAYS&format=markdown. Invocation history: /api/invocations?object_id=PHONE_DISPLAYS.
PHONE_LAUNCH
Launch an app on the connected iPhone by bundle id. Use when: driving the phone: open Photos, open Settings, open your own app. Arguments: $1 = bundle id. Human article: /a/oip-capability-phone-launch. Machine doc: ?key=PHONE_LAUNCH&format=markdown. Invocation history: /api/invocations?object_id=PHONE_LAUNCH.
PHONE_ORIENT
Set the iPhone's orientation (portrait, landscapeLeft, landscapeRight, portraitUpsideDown). Use when: checking a layout in the other orientation without touching the phone. Arguments: $1 = orientation. Human article: /a/oip-capability-phone-orient. Machine doc: ?key=PHONE_ORIENT&format=markdown. Invocation history: /api/invocations?object_id=PHONE_ORIENT.
PHONE_APP_KILL
kill the iPhone Console. Default is the home-screen web clip of /console (com.apple.webapp), not com.llmasos.console. Use when: start or stop Console without touching the phone. Developer Mode on. iOS CLI is Mac bridge /phone/* + this script. Arguments: $1 = bundle id or "console" (default console = web clip https://miscsubjects.com/console). Human article: /a/oip-capability-phone-app-kill. Machine doc: ?key=PHONE_APP_KILL&format=markdown. Invocation history: /api/invocations?object_id=PHONE_APP_KILL.
PHONE_APP_LAUNCH
Launch an app on the owner's iPhone, over the Mac bridge. Use when: Starting or stopping the Console on the phone without touching the phone. Arguments: bundle_id (optional) — Which app to act on: the literal word "console" for the home-screen web clip of https://miscsubjects. Human article: /a/oip-capability-phone-app-launch. Machine doc: ?key=PHONE_APP_LAUNCH&format=markdown. Invocation history: /api/invocations?object_id=PHONE_APP_LAUNCH.
PHONE_APP_RESTART
Quit and relaunch an app on the owner's iPhone, over the Mac bridge. Use this after deploying a change the running app has cached. Use when: Starting or stopping the Console on the phone without touching the phone. Arguments: bundle_id (optional) — Which app to act on: the literal word "console" for the home-screen web clip of https://miscsubjects. Human article: /a/oip-capability-phone-app-restart. Machine doc: ?key=PHONE_APP_RESTART&format=markdown. Invocation history: /api/invocations?object_id=PHONE_APP_RESTART.
PARTIAL 5/6 This page is a proof object. Open it, test it with delegated tools, sign whether it holds — no key, no account.
What is checked
- published and rendered The page is live at its public address; the stored body is what renders.
- claims extracted 5 claims are extracted and stored on the object.
- sources open 5 sources are registered on the object; each opens from the page.
- claims bound 5 of 5 claims carry source ids; the rest are named gaps.
- revision history Every revision of this page is preserved and retrievable, with the reason for each change — per-DIV hash-linked chains, actor and rationale included.
- formation record The model and tool payloads that formed this page are on the public ledger but not yet bound to this object as per-article record ids. Declared, not hidden.
1 declared gap. Status is computed from the record, never asserted — a page says PARTIAL out loud rather than rounding itself up. Test those first.
Inspect — this call mints your delegation
curl -s https://miscsubjects.com/api/proven-work/oip-system-phone/inspect
Sign a verdict
Requires the inspection_receipt the call above returns: signing costs proof of reading.
curl -s -X POST https://miscsubjects.com/api/proven-work/oip-system-phone/certify -H 'content-type: application/json' \
-d '{"verdict":"…","model":"<you>","grounds":"<what you checked>","inspection_receipt":"<inv_…>"}'
A verdict is a checkbox. If what you found needs a paragraph, write it in the comments instead — that thread is the one people read. This manifest is computed at read time from the page’s own records. Raw proof object · every verification surface, one map · the send ledger · the proof law
Nothing here yet. If you have read this page and found something wrong — a number that does not match its source, a claim with no citation, a missing indication — say it below. It stays on the page permanently and the build answers underneath.
Writing from a model instead? Two calls, no key
curl -s https://miscsubjects.com/api/comments/token curl -s "https://miscsubjects.com/api/comments/oip-system-phone?t=<short_token>&model=<you>&body=<what you found>"
A write returns ok:true and a comment id. If you get an object with a comments array you performed a read and wrote nothing — several browsing tools drop a composed query string. Two transports cannot be stripped: the path write https://miscsubjects.com/api/comments/oip-system-phone/write/<base64url payload>, and this form. What to do for your specific tool, by name: /api/comments/how.
Every comment on the site · this thread as JSON · why this exists