sidebud 0.1.0

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "sidebud",
+  "version": "0.1.0",
+  "description": "Sidebud companion: talk to the agents on your computer from your phone.",
+  "keywords": [
+    "sidebud",
+    "voice",
+    "assistant",
+    "agents",
+    "companion",
+    "mcp"
+  ],
+  "homepage": "https://sidebud.app",
+  "author": "JJ Eaton",
+  "license": "UNLICENSED",
+  "type": "module",
+  "bin": {
+    "sidebud": "dist/cli.js",
+    "rva-companion": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "src/manage",
+    "packs",
+    "THIRD_PARTY_NOTICES.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.280",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@noble/curves": "^2.0.1",
+    "@noble/hashes": "^2.0.1",
+    "diff": "^8.0.4",
+    "qrcode": "^1.5.4",
+    "ws": "^8.18.3",
+    "zod": "^4.5.4"
+  }
+}

package/packs/BRAND_ASSETS.md

@@ -0,0 +1,8 @@
+# Integration logos
+
+The Gmail and Google Calendar `logo.png` files identify their respective integrations. They are rendered at 192 px from Google's official product assets, retrieved 2026-09-23:
+
+- https://www.gstatic.com/images/branding/productlogos/gmail_2026/v2/web/192px.svg
+- https://www.gstatic.com/images/branding/productlogos/calendar_2026/v2/web/192px.svg
+
+Google retains its trademarks and rights in these logos; they are not covered by this repository's MIT license. Their use does not imply Google endorsement. The companion serves the small raster files by content hash over the paired connection; the mobile widget JSON contains only that hash.

package/packs/calendar/pack.json

@@ -0,0 +1,127 @@
+{
+  "schemaVersion": 1,
+  "id": "dev.remotevoiceagent.calendar",
+  "name": "Calendar",
+  "description": "Upcoming events and calendar availability. Read-only Google API access stays on your computer.",
+  "version": "1.0.2",
+  "author": {
+    "name": "Sidebud"
+  },
+  "license": "MIT",
+  "logo": {
+    "kind": "file",
+    "path": "logo.png"
+  },
+  "tile": {
+    "size": "medium"
+  },
+  "mcp": {
+    "transport": "builtin",
+    "service": "calendar"
+  },
+  "auth": {
+    "type": "oauth2",
+    "authorizationUrl": "https://accounts.google.com/o/oauth2/v2/auth",
+    "tokenUrl": "https://oauth2.googleapis.com/token",
+    "scopes": [
+      "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
+      "https://www.googleapis.com/auth/calendar.events.readonly",
+      "https://www.googleapis.com/auth/calendar.events.freebusy"
+    ],
+    "clientIdSecret": "GOOGLE_OAUTH_CLIENT_ID",
+    "clientSecretSecret": "GOOGLE_OAUTH_CLIENT_SECRET",
+    "authorizationParams": {
+      "access_type": "offline",
+      "prompt": "consent"
+    }
+  },
+  "secrets": [
+    {
+      "name": "GOOGLE_OAUTH_CLIENT_ID",
+      "description": "Desktop OAuth client ID with Calendar API enabled"
+    },
+    {
+      "name": "GOOGLE_OAUTH_CLIENT_SECRET",
+      "description": "Desktop OAuth client secret"
+    }
+  ],
+  "permissions": {
+    "tools": [
+      {
+        "name": "list_calendars",
+        "access": "read",
+        "description": "List calendars"
+      },
+      {
+        "name": "list_events",
+        "access": "read",
+        "description": "Read upcoming events"
+      },
+      {
+        "name": "get_event",
+        "access": "read",
+        "description": "Read one event"
+      },
+      {
+        "name": "get_free_busy",
+        "access": "read",
+        "description": "Read availability"
+      }
+    ],
+    "network": [
+      "www.googleapis.com",
+      "accounts.google.com",
+      "oauth2.googleapis.com"
+    ]
+  },
+  "settings": [
+    {
+      "id": "calendarId",
+      "label": "Calendar ID",
+      "type": "text",
+      "default": "primary",
+      "description": "Use primary for your main calendar."
+    }
+  ],
+  "data": [
+    {
+      "id": "upcoming",
+      "tool": "list_events",
+      "arguments": {
+        "calendarId": "{{setting.calendarId}}",
+        "pageSize": 20
+      },
+      "refreshSeconds": 60
+    }
+  ],
+  "glance": {
+    "stats": [
+      {
+        "label": "Next 7 days",
+        "value": "{{upcoming/events|count}}",
+        "tone": "info"
+      }
+    ]
+  },
+  "blocks": [
+    {
+      "type": "list",
+      "items": "{{upcoming/events}}",
+      "item": {
+        "title": "{{item/summary}}",
+        "subtitle": "{{item/startsAt}}"
+      },
+      "limit": 10,
+      "emptyText": "No upcoming events."
+    }
+  ],
+  "controls": [
+    {
+      "id": "agenda",
+      "kind": "prompt",
+      "label": "Read my agenda",
+      "prompt": "Summarize my upcoming calendar events.",
+      "default": true
+    }
+  ]
+}

package/packs/discord/pack.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "../../../../docs/schemas/pack-v2.schema.json",
+  "schemaVersion": 2,
+  "id": "dev.remotevoiceagent.discord",
+  "name": "Discord",
+  "description": "A Discord channel through a bot (barryyip0625/mcp-discord). Bots see only servers they are in and DMs sent to the bot, never your personal DMs. Read-only here.",
+  "version": "1.1.0",
+  "author": {
+    "name": "Sidebud"
+  },
+  "license": "MIT",
+  "logo": {
+    "kind": "icon",
+    "name": "chat"
+  },
+  "tile": {
+    "size": "small"
+  },
+  "mcp": {
+    "transport": "stdio",
+    "command": "npx",
+    "args": [
+      "-y",
+      "mcp-discord@1.5.1"
+    ],
+    "env": {
+      "DISCORD_TOKEN": "{{secret.DISCORD_TOKEN}}"
+    }
+  },
+  "secrets": [
+    {
+      "name": "DISCORD_TOKEN",
+      "description": "A bot token from the Discord Developer Portal (never a user token: that breaks Discord's terms)"
+    }
+  ],
+  "permissions": {
+    "tools": [
+      {
+        "name": "discord_read_messages",
+        "access": "read",
+        "description": "Messages in a channel",
+        "argumentSettings": {
+          "channelId": "channelId"
+        }
+      }
+    ]
+  },
+  "settings": [
+    {
+      "id": "channelId",
+      "label": "Channel id",
+      "type": "text",
+      "default": "",
+      "description": "The channel (or bot DM channel) to watch; enable Developer Mode in Discord and copy the channel id.",
+      "required": true
+    }
+  ],
+  "data": [
+    {
+      "id": "recent",
+      "tool": "discord_read_messages",
+      "arguments": {
+        "channelId": "{{setting.channelId}}",
+        "limit": 20
+      },
+      "extract": "text-json",
+      "refreshSeconds": 30
+    }
+  ],
+  "glance": {
+    "line": "{{recent/messages/0/author/username|default:No messages}}: {{recent/messages/0/content|truncate:50}}"
+  },
+  "blocks": [
+    {
+      "type": "list",
+      "items": "{{recent/messages}}",
+      "item": {
+        "title": "{{item/author/username}}",
+        "subtitle": "{{item/content|truncate:120}}"
+      },
+      "limit": 8,
+      "emptyText": "No messages"
+    }
+  ],
+  "controls": [
+    {
+      "id": "summarize",
+      "kind": "prompt",
+      "label": "Summarize the channel",
+      "prompt": "Summarize the recent messages in my Discord channel.",
+      "default": true
+    }
+  ],
+  "alerts": [
+    {
+      "id": "incoming",
+      "items": "{{recent/messages}}",
+      "key": "{{item/id}}",
+      "sender": [
+        "{{item/author/username}}",
+        "{{item/author/id}}"
+      ],
+      "text": "{{item/content}}",
+      "fromMe": "{{item/author/bot}}"
+    }
+  ]
+}

package/packs/filesystem/pack.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "../../../../docs/schemas/pack-v2.schema.json",
+  "schemaVersion": 2,
+  "id": "app.sidebud.filesystem",
+  "name": "Filesystem",
+  "description": "Read and search one explicitly selected folder on this computer. This baseline exposes no write tools.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Sidebud"
+  },
+  "license": "MIT",
+  "logo": {
+    "kind": "emoji",
+    "value": "\ud83d\udcc1"
+  },
+  "controls": [
+    {
+      "id": "summarize",
+      "kind": "prompt",
+      "label": "Summarize",
+      "prompt": "Summarize the information available through my Filesystem integration.",
+      "default": true
+    }
+  ],
+  "mcp": {
+    "transport": "stdio",
+    "command": "npx",
+    "args": [
+      "-y",
+      "@modelcontextprotocol/server-filesystem@2026.8.31",
+      "{{setting.folder}}"
+    ]
+  },
+  "settings": [
+    {
+      "id": "folder",
+      "label": "Allowed folder",
+      "type": "text",
+      "required": true,
+      "format": "directory",
+      "description": "An existing absolute folder. Select the smallest folder needed; do not select your home or disk root."
+    }
+  ],
+  "permissions": {
+    "tools": [
+      {
+        "name": "read_text_file",
+        "access": "read"
+      },
+      {
+        "name": "list_directory",
+        "access": "read"
+      },
+      {
+        "name": "search_files",
+        "access": "read"
+      },
+      {
+        "name": "get_file_info",
+        "access": "read"
+      }
+    ]
+  },
+  "data": [
+    {
+      "id": "files",
+      "tool": "list_directory",
+      "arguments": {
+        "path": "{{setting.folder}}"
+      },
+      "extract": "text",
+      "refreshSeconds": 300
+    }
+  ],
+  "glance": {
+    "line": "{{setting.folder}}"
+  },
+  "blocks": [
+    {
+      "type": "text",
+      "text": "{{files|truncate:550}}"
+    }
+  ]
+}

package/packs/github/pack.json

@@ -0,0 +1,127 @@
+{
+  "$schema": "../../../../docs/schemas/pack-v2.schema.json",
+  "schemaVersion": 2,
+  "id": "app.sidebud.github",
+  "name": "GitHub",
+  "description": "Read issues, pull requests, and files in one selected repository through GitHub\u2019s official hosted MCP server.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Sidebud"
+  },
+  "license": "MIT",
+  "logo": {
+    "kind": "emoji",
+    "value": "\ud83d\udc19"
+  },
+  "controls": [
+    {
+      "id": "summarize",
+      "kind": "prompt",
+      "label": "Summarize",
+      "prompt": "Summarize the information available through my GitHub integration.",
+      "default": true
+    }
+  ],
+  "mcp": {
+    "transport": "http",
+    "url": "https://api.githubcopilot.com/mcp/readonly",
+    "headers": {
+      "Authorization": "Bearer {{secret.GITHUB_TOKEN}}"
+    }
+  },
+  "secrets": [
+    {
+      "name": "GITHUB_TOKEN",
+      "description": "Fine-grained token restricted to the selected repository, with read access to contents, issues, and pull requests."
+    }
+  ],
+  "settings": [
+    {
+      "id": "owner",
+      "label": "Repository owner",
+      "type": "text",
+      "required": true
+    },
+    {
+      "id": "repo",
+      "label": "Repository name",
+      "type": "text",
+      "required": true
+    }
+  ],
+  "permissions": {
+    "network": [
+      "api.githubcopilot.com"
+    ],
+    "tools": [
+      {
+        "name": "list_issues",
+        "access": "read",
+        "argumentSettings": {
+          "owner": "owner",
+          "repo": "repo"
+        }
+      },
+      {
+        "name": "list_pull_requests",
+        "access": "read",
+        "argumentSettings": {
+          "owner": "owner",
+          "repo": "repo"
+        }
+      },
+      {
+        "name": "issue_read",
+        "access": "read",
+        "argumentSettings": {
+          "owner": "owner",
+          "repo": "repo"
+        }
+      },
+      {
+        "name": "pull_request_read",
+        "access": "read",
+        "argumentSettings": {
+          "owner": "owner",
+          "repo": "repo"
+        }
+      },
+      {
+        "name": "get_file_contents",
+        "access": "read",
+        "argumentSettings": {
+          "owner": "owner",
+          "repo": "repo"
+        }
+      }
+    ]
+  },
+  "data": [
+    {
+      "id": "issues",
+      "tool": "list_issues",
+      "arguments": {
+        "owner": "{{setting.owner}}",
+        "repo": "{{setting.repo}}",
+        "state": "OPEN",
+        "perPage": 8
+      },
+      "refreshSeconds": 300
+    }
+  ],
+  "glance": {
+    "line": "{{setting.owner}}/{{setting.repo}}"
+  },
+  "blocks": [
+    {
+      "type": "list",
+      "items": "{{issues/issues}}",
+      "item": {
+        "title": "{{item/title}}",
+        "subtitle": "#{{item/number}}"
+      },
+      "limit": 8,
+      "emptyText": "No open issues"
+    }
+  ]
+}