facebook/meta-wearables-dat-ios/session-lifecycle
Claude Code and agent skill by facebook/meta-wearables-dat-ios
- community
Checking that the SKILL.md file is still in the repository.
Device session states, pause/resume, availability monitoring
Install
npx vskill@latest install facebook/meta-wearables-dat-ios/session-lifecycleSKILL.md
The same SKILL.md was published earlier as facebook/meta-wearables-dat-ios/session-lifecycle.
Session Lifecycle (iOS)
Guide for managing device session states in DAT SDK integrations.
Overview
The DAT SDK runs work inside sessions. Meta glasses expose two experience types:
- Device sessions — sustained access to device sensors and outputs
- Transactions — short, system-owned interactions (notifications, "Hey Meta")
Your app observes session state changes. Your app drives start(), pause(), resume(), and stop(); the device can also pause, resume, or stop the session on its own.
Session states
| State | Meaning | App action | |
|---|---|---|---|
idle | Session created but not started | Call start() when ready | |
starting | Session is connecting to the device | Show connecting state | |
started | Session active and ready for capabilities | Add or resume work | |
paused | Temporarily suspended by pause() or the device | Hold work; call resume() or wait for the device to resume | |
stopping | Session is cleaning up | Wait for terminal state | |
stopped | Session inactive and terminal | Free resources, create a new session to restart |
Observing session state
DeviceSession exposes both shapes: stateStream() / errorStream() as AsyncStream, and statePublisher / errorPublisher as listener-token Announcers. Pick one per call site; subscribe before calling start() so no initial transition is missed.
Session errors
errorStream() and errorPublisher emit DeviceSessionError. Handle .noEligibleDevice (no matching device yet), .sessionAlreadyExists, .capabilityAlreadyActive, the thermal/battery cases (.thermalCritical, .thermalEmergency, .peakPowerShutdown, .batteryCritical), and .datAppOnTheGlassesUpdateRequired, which is delivered as a one-shot event and should open Wearables.shared.openDATGlassesAppUpdate().
start() uses typed throws, so you can catch the specific case:
Stream state transitions
A Stream is a capability attached to a started DeviceSession:
Common transitions
The device changes session state when:
- User performs a system gesture that opens another experience
- Another app starts a device session
- User removes or folds the glasses (Bluetooth disconnects)
- User removes the app from Meta AI companion app
- Connectivity between companion app and glasses drops
Pause and resume
Call pause() on a started session and resume() on a paused one. Both are sync fire-and-forget and do not throw: observe stateStream() or statePublisher for the started → paused → started transitions. pause() outside started and resume() outside paused are no-ops. The state changes only when the device confirms, so wait for paused before calling resume() (and for started before calling pause() again); earlier calls are ignored. If the observed state doesn't match what your app wants, call pause() or resume() again once it settles.
The device can also pause and resume the session on its own (for example a single touchpad tap). When a session is paused:
- The device keeps the connection alive
- Streams stop delivering data
- The session returns to
startedwhen your app callsresume()or the device resumes it
Your app should not restart the session while paused — call resume() or wait for started or stopped.
Device availability
Monitor device availability to know when sessions can start:
A DeviceSelector also reports availability directly. AutoDeviceSelector and SpecificDeviceSelector both expose activeDevice and activeDeviceStream(), which yields nil when no eligible device is available:
Key behaviors:
- Closing hinges disconnects Bluetooth → forces
stopped - Opening hinges restores Bluetooth but does not restart sessions
- Start a new session after the device becomes available again
Implementation checklist
- [ ] Handle all relevant session states (
started,paused,stopped) - [ ] Monitor device availability before starting work
- [ ] Release resources only after
stopped - [ ] Don't infer transition causes — rely only on observable state
- [ ] Don't restart during
paused— callresume()or wait for the device to resume or stop
Links
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugins/mwdat-ios/skills/session-lifecycle/SKILL.md
Popularity
- Repository stars
- 566
- Repository forks
- 123
- 7-day trend score
- 31
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/facebook/meta-wearables-dat-ios/session-lifecycle)