@plusonelabs/cue 0.0.93 → 0.0.95

package/dist/skills/notify/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: notify
+description: Send push notifications to the user via `cue notify`. Use when sending alerts, reminders, or updates to the user's mobile device.
+category: comms
+type: context
+metadata:
+  short-description: Send push notifications
+  scope: first-party
+---
+
+Send push notifications to the user using the Cue CLI.
+
+## Requirements
+
+- `cue` CLI installed and authenticated (`cue` then `/auth`)
+- User must have registered a device token (via iOS/Android app)
+- Valid category: `messages`, `responses`, `automations`, `reminders`, `social`, `billing`, `system`
+
+## Usage
+
+```bash
+cue notify "Title" "Message body" [category]
+```
+
+### Use a specific account
+
+List available profiles and test connection:
+
+```bash
+cue auth list     # List all accounts
+cue auth status   # Test current connection
+```
+
+Then use `--profile cue:{account-name}` to send as a different account:
+
+```bash
+cue --profile cue:work notify "Build Done" "Completed successfully"
+```
+
+### With custom data
+
+```bash
+cue notify "Reminder" "Call dentist" reminders --data '{"reminder_id":"abc-123"}'
+```
+
+## Parameters
+
+| Parameter    | Required | Description                        |
+| ------------ | -------- | ---------------------------------- |
+| `--title`    | Yes      | Notification title (max 200 chars) |
+| `--body`     | Yes      | Notification body (max 1000 chars) |
+| `--category` | Yes      | Notification category (see below)  |
+| `--data`     | No       | Custom JSON data payload           |
+
+## Categories
+
+| Category      | Use for                      |
+| ------------- | ---------------------------- |
+| `messages`    | Chat messages                |
+| `responses`   | AI assistant replies         |
+| `automations` | Scheduled automation results |
+| `reminders`   | User-set reminders           |
+| `social`      | Friend requests, mentions    |
+| `billing`     | Payment alerts               |
+| `system`      | Account alerts, security     |
+
+## Examples
+
+### System notification
+
+```bash
+cue notify --title "Update Available" --body "A new version of Cue is available" --category "system"
+```
+
+### Reminder notification
+
+```bash
+cue notify --title "Reminder" --body "Time for your daily standup" --category "reminders"
+```
+
+### Automation result
+
+```bash
+cue notify --title "Expense Report" --body "Weekly expense report generated: $342.50" --category "automations" --data '{"report_id":"xyz-789"}'
+```
+
+### Social notification
+
+```bash
+cue notify --title "New Friend Request" --body "Alex wants to connect" --category "social" --data '{"user_id":"abc-123"}'
+```
+
+## Response
+
+On success:
+
+```json
+{
+  "success": true,
+  "push_sent": true,
+  "push_results": [{ "token": "4ad461...", "success": true, "error": null }]
+}
+```
+
+If skipped (e.g., muted or no device):
+
+```json
+{
+  "success": true,
+  "push_sent": false,
+  "skipped_reason": "no_device_tokens"
+}
+```
+
+## Troubleshooting
+
+| Error                  | Fix                                                   |
+| ---------------------- | ----------------------------------------------------- |
+| Not authenticated      | Run `cue` then `/auth` to log in                      |
+| Authentication expired | Re-authenticate with `/auth`                          |
+| Profile not found      | Check account name with `cue auth list`               |
+| no_device_tokens       | User hasn't registered a device token via mobile app  |
+| User preferences block | User has muted this category in notification settings |

package/dist/skills/places/SKILL.md

@@ -0,0 +1,215 @@
+---
+name: places
+description: Search and explore places via `cue place`. Text search, nearby search, autocomplete, resolve locations, get place details and photos using Google Places API.
+category: data
+type: context
+metadata:
+  short-description: Search and explore places
+  scope: first-party
+---
+
+Search and explore places using the Cue CLI. Proxies Google Places API (New) through the backend.
+
+## Requirements
+
+- `cue` CLI installed and authenticated (`cue` then `/auth`)
+
+## Usage
+
+### Text search
+
+```bash
+cue place search '{"query":"coffee shop"}'
+cue place search '{"query":"pizza","location_bias":{"lat":40.8,"lng":-73.9,"radius_m":3000}}'
+cue place search '{"query":"cafe","filters":{"open_now":true,"min_rating":4.0},"limit":5}'
+```
+
+### Nearby search
+
+```bash
+cue place nearby '{"location":{"lat":40.8,"lng":-73.9,"radius_m":1500},"included_types":["restaurant"]}'
+cue place nearby '{"location":{"lat":40.8,"lng":-73.9,"radius_m":2000},"excluded_types":["fast_food"],"limit":10}'
+```
+
+### Autocomplete
+
+```bash
+cue place autocomplete '{"input":"cof"}'
+cue place autocomplete '{"input":"star","location_bias":{"lat":40.8,"lng":-73.9,"radius_m":5000},"limit":5}'
+```
+
+### Resolve location text to coordinates
+
+```bash
+cue place resolve '{"location_text":"Soho, London"}'
+cue place resolve '{"location_text":"Times Square, NYC","limit":3}'
+```
+
+### Get place details
+
+```bash
+cue place get <place_id>
+cue place get <place_id> --reviews --photos
+```
+
+### Get photo URL
+
+```bash
+cue place photo <place_id> <photo_name>
+```
+
+The `photo_name` comes from the `photos[].name` field in place details.
+
+### Use a specific account
+
+```bash
+cue --profile cue:work place search '{"query":"office space"}'
+```
+
+## Request Parameters
+
+### Search
+
+| Field           | Type   | Required | Description                                   |
+| --------------- | ------ | -------- | --------------------------------------------- |
+| `query`         | string | Yes      | Search text                                   |
+| `location_bias` | object | No       | `{lat, lng, radius_m}` to bias results        |
+| `filters`       | object | No       | `{open_now, min_rating, types, price_levels}` |
+| `limit`         | number | No       | Max results (default 10, max 20)              |
+| `language`      | string | No       | Language code (e.g. "en")                     |
+| `region`        | string | No       | Region code (e.g. "US")                       |
+| `page_token`    | string | No       | Pagination token                              |
+
+### Nearby
+
+| Field            | Type     | Required | Description                      |
+| ---------------- | -------- | -------- | -------------------------------- |
+| `location`       | object   | Yes      | `{lat, lng, radius_m}`           |
+| `included_types` | string[] | No       | Place types to include           |
+| `excluded_types` | string[] | No       | Place types to exclude           |
+| `limit`          | number   | No       | Max results (default 10, max 20) |
+
+### Autocomplete
+
+| Field           | Type   | Required | Description                         |
+| --------------- | ------ | -------- | ----------------------------------- |
+| `input`         | string | Yes      | Partial text to complete            |
+| `session_token` | string | No       | UUID for billing grouping           |
+| `location_bias` | object | No       | `{lat, lng, radius_m}`              |
+| `limit`         | number | No       | Max suggestions (default 5, max 20) |
+| `language`      | string | No       | Language code                       |
+
+### Resolve
+
+| Field           | Type   | Required | Description                     |
+| --------------- | ------ | -------- | ------------------------------- |
+| `location_text` | string | Yes      | Location description            |
+| `limit`         | number | No       | Max results (default 5, max 10) |
+
+## Response Format
+
+### Search / Nearby
+
+```json
+{
+  "results": [
+    {
+      "place_id": "ChIJ...",
+      "name": "Blue Bottle Coffee",
+      "address": "123 Main St, New York, NY",
+      "location": { "lat": 40.801, "lng": -73.968 },
+      "rating": 4.5,
+      "price_level": 2,
+      "types": ["cafe", "food"],
+      "open_now": true
+    }
+  ],
+  "next_page_token": "..."
+}
+```
+
+### Autocomplete
+
+```json
+{
+  "suggestions": [
+    {
+      "kind": "place",
+      "place_id": "ChIJ...",
+      "text": "Coffee Shop NYC",
+      "main_text": "Coffee Shop",
+      "secondary_text": "NYC",
+      "types": ["cafe"],
+      "distance_meters": 450
+    }
+  ]
+}
+```
+
+### Place Details
+
+```json
+{
+  "place_id": "ChIJ...",
+  "name": "Blue Bottle Coffee",
+  "address": "123 Main St, New York, NY",
+  "location": { "lat": 40.801, "lng": -73.968 },
+  "rating": 4.5,
+  "price_level": 2,
+  "types": ["cafe", "food"],
+  "phone": "+1 212-555-0123",
+  "website": "https://bluebottlecoffee.com",
+  "hours": ["Monday: 7:00 AM – 7:00 PM"],
+  "open_now": true,
+  "reviews": [],
+  "photos": [
+    { "name": "places/.../photos/...", "width_px": 800, "height_px": 600 }
+  ]
+}
+```
+
+## Price Levels
+
+| Value | Meaning        |
+| ----- | -------------- |
+| 0     | Free           |
+| 1     | Inexpensive    |
+| 2     | Moderate       |
+| 3     | Expensive      |
+| 4     | Very Expensive |
+
+## Examples
+
+### Find nearby restaurants
+
+```bash
+cue place nearby '{"location":{"lat":37.7749,"lng":-122.4194,"radius_m":1000},"included_types":["restaurant"],"limit":5}'
+```
+
+### Search with filters
+
+```bash
+cue place search '{"query":"sushi","location_bias":{"lat":37.7749,"lng":-122.4194,"radius_m":2000},"filters":{"open_now":true,"min_rating":4.0,"price_levels":[1,2]}}'
+```
+
+### Get details with reviews
+
+```bash
+cue place get ChIJOwg_06VPwokRYv534QaPC8g --reviews --photos
+```
+
+### Resolve a location
+
+```bash
+cue place resolve '{"location_text":"Central Park, New York"}'
+```
+
+## Troubleshooting
+
+| Error                     | Fix                                             |
+| ------------------------- | ----------------------------------------------- |
+| Not authenticated         | Run `cue` then `/auth` to log in                |
+| Authentication expired    | Re-authenticate with `/auth`                    |
+| Invalid JSON              | Check JSON syntax                               |
+| 500 Internal Server Error | Google Places API key not configured on backend |
+| 502 Bad Gateway           | Google API returned an error (check query)      |