Port OS Smart Home

Control devices/services. Dispatch a declared message with the payload its discovery entry shows ({} if fieldless) to one discovered logical id or endpoint_query-style query. Named devices, including dim/color, require their endpoint; groups require room/group intent. Unqualified vacuum start is whole-device. Queries freeze 1-100 authorized matches; zero/over-limit sends nothing. Copy references/account; Port OS selects routes. Whole-home lights: one complete confirmed-lighting query; rooms: resolved lighting group. Query adds no exclusions. Include confirmed lamps/plugs; exclude appliances, fans, simulators, catalogs and duplicates. Discover missing scope only; report unresolved coverage. Commands: waitForResult=false; acknowledge accepted/pending and stop, without auto-poll/read/card. State/settings: endpoint_query with expand and forceDeviceAttributeQuery:true. Replies (snapshots, SDP, searches, queues, scene creation, authorization challenges): wait true. Empty QUEUED/IN_PROGRESS remains pending; acceptance proves no physical state. Exception: after play-media or launch-application on a TELEVISION, confirm once before saying it plays (an app can stop on a profile picker): endpoint_query forceDeviceAttributeQuery:true, or snapshot/get-snapshot {"responseFormat":"BASE64"} (the default URL cannot be viewed), and follow the TV description if it is stuck. Tools-only recipes: media-search/search-media {"query":"<search>","type":"track"} (type is lower case; supportedSearchTypes lists TRACK upper case); media-queue/play-queue {"mediaIds":["<returned ID>"]}; get-queue {}; add-to-queue {"mediaId":"<returned ID>"}, plus fresh queueVersion only when requiresQueueVersion=true. Match declared resources/bounds. Queue differs from saved playlist; failed search proves no state. Scenes: group_query expand:["scene"], forceDeviceAttributeQuery:true; scene/activate {"sceneId":"<returned ID>"}; scene/create-scene {"name":"<name>"} captures settings, wait true. Recover uncertain…

Edit endpoint registry metadata; physical actions use control. Read endpoint ID, document and etag first. Metadata replacement requires complete name/type/enablement, etag and idempotencyKey; rename/type/disabled state survives rediscovery. Disabled endpoints remain explicitly readable but reject controls. DELETE may be rediscovered. MERGE_INTO disables the source and moves supported references; it creates no ID alias and preserves target enablement. Two simulator endpoints cannot merge (409 CONFLICT); disable/delete the duplicate instead. Confirm exact identity and explain MERGE_INTO/DELETE effects; matching names do not prove duplicates.

Find devices/services, declarations and observations. Filter by name/type/capability; follow paginationContext.nextToken for the requested scope. endpointId reads one known endpoint and takes no query, maxResults or nextToken. Copy returned references/account; Port OS selects routes. Use group_query for rooms and management tools for inventory edits. State reads require declared expand capabilities and forceDeviceAttributeQuery=true. FRESH is current; STALE is last known with sampledAt and cannot support a safety claim. Missing/invalid/errored/PROVIDER_NO_STATE is unknown; PROVIDER_NO_STATE is not offline and retries cannot supply an absent provider value. FRESH UNREACHABLE is offline; STALE connectivity is last known. ID-only lookup reads metadata; an expanded read returns only the expanded capabilities, without the description. simulator:true means all routes are synthetic; routes[].simulator marks mixed routes. Missing flags are unknown. Exclude simulated routes from household claims unless explicitly selected; their readings do not prove physical state. Types alone do not identify lamps: switches/plugs require confirmed lighting assignment. Temperature setpoints are distinct from ambient readings; clarify indoor/outdoor ambiguity. Check relevant authorized accounts before reporting absence; names alone prove no identity. Select concrete route-backed services, not provider catalogs or obsolete unrouted entries. Default lists include ENABLED; DISABLED or * selects others. Exact endpointId can read disabled metadata. controllableGroups needs group:read. Device workflows and payloads: matching Port OS skill or portos://guides/index.

Open the Port OS device UI when requested; never draw a second card/map/controls. Answer with the relevant value in words. This tool shares endpoint_query selection, expand and pagination. One matching endpoint opens controls; multiple matches open a selection list. It sends no control and starts no live video. primary selects a returned cardId (for example battery, fan, closure, camera, location or house-map) and refreshes its readings; unsupported IDs return available choices. Other cards remain in details. Results include cached readings for listed cards, so avoid a second read. FRESH is current; STALE is last known with its age. Ordinary commands require no automatic UI follow-up.

Create/rename/delete groups, change members/enablement or merge inventory; physical actions use control. Read IDs/etags first. Every batch reference to a group uses its starting etag. MOVE_MEMBER needs memberEndpointId plus source/target IDs and both etags. List order cannot resolve contradictory edits; adding does not implicitly move exclusive membership. Native-capable changes default to BEST_EFFORT: provider change/readback precedes local intent; failure can fall back locally as PARTIALLY_APPLIED. PORTOS_ONLY sends nothing. FAIL_ON_PROVIDER_ERROR fails intent while retaining received provider facts. Native effects cannot roll back. NOT_DECLARED alone is not partial; OUTSIDE_PRINCIPAL prevents native changes through another principal. MERGE_INTO and aggregate/route enablement require PORTOS_ONLY. Require explicit user authorization for exact MERGE_INTO/DELETE_GROUP targets/effects. Deletion may delete native groups; unretired routes stay disabled/orphaned against rediscovery. Route enablement needs its native etag and groupEtag when grouped. Use declared provider support; robot room edits do not reshape maps. validateOnly=true authorizes/plans without sending/writing. Otherwise use a unique idempotencyKey per intent; identical retries retain it. Stale etag: reread/reconsider. Inspect batch status, per-item outcomes and providerDispatches, including on failure. Failed intent can retain provider changes; never claim full synchronization or automatically repeat native writes.

Find rooms/groups with IDs, etags, hierarchy, members, controllers, providers and declared controls. Query a named room; omit query for inventory. Follow relevant pages. Clarify ambiguous names using parentPath. id reads one group; merged IDs return redirectedFrom. Copy IDs/etags. Use control on the complete logical group; Port OS selects native/equivalent member delivery. Native capabilities/membershipComplete prove no aggregate coverage. membershipComplete=false means incomplete; absent means unknown. Empty resolved members do not prove an empty native group. Disabled routes cannot control; disabled groups need re-enablement through group_manage. Controllers accept group-scoped actions: target the vacuum controller with {"groupIds":["<group ID>"]} for room cleaning. Requested maps use endpoint_show on that controller, primary house-map; never draw geometry. expand selects observations; forceDeviceAttributeQuery refreshes them. Omitted/failed fresh values are unavailable. Disabled groups are hidden unless enablement=DISABLED or *.

Stop watching by cancelling one Port OS event subscription using its exact ID from subscription_list or subscription_inspect. Cancellation is idempotent. Select the intended subscription by name, source endpoint and catalog event; names are not cancellation keys. A stopped monitor requires a new subscription to watch again.

Inspect one Port OS event subscription by its exact ID returned by subscription_list. Returns its safe query, source endpoint, catalog name and lifecycle status. A retained active subscription establishes registration; it does not prove that any client has received or acted on a camera event.

Change only the display name of one Port OS event subscription by exact ID. Use a PLAIN name-value object. The event, endpoint, filter and destination are immutable; to change what is watched, establish a replacement monitor and cancel the old ID.

Enumerate the user's Port OS event subscriptions, including their exact IDs, names, source endpoint, catalog event and status. For requests to stop watching a camera, list subscriptions and follow every nextCursor, select the intended monitor, then use subscription_cancel with its exact ID. Creating a monitor uses the host's events/subscribe capability after discovering supported camera events; these tools never accept callback URLs or signing keys.