sidebud 0.1.0

package/packs/t3-agents/pack.json

@@ -0,0 +1,492 @@
+{
+  "$schema": "../../../../docs/schemas/pack-v2.schema.json",
+  "schemaVersion": 2,
+  "id": "app.sidebud.t3-agents",
+  "name": "T3 Agents",
+  "description": "Your T3 Code agents through the T3 MCP Gateway on this computer: see threads on the phone, and let the execution agent start, message, review, and control them. T3 Agents must be installed with its MCP Gateway enabled.",
+  "version": "1.3.1",
+  "author": {
+    "name": "Sidebud"
+  },
+  "license": "MIT",
+  "logo": {
+    "kind": "file",
+    "path": "logo.png"
+  },
+  "tile": {
+    "size": "medium"
+  },
+  "controls": [
+    {
+      "id": "status",
+      "kind": "prompt",
+      "label": "What's running",
+      "prompt": "Summarize what my T3 agents are working on and anything that needs me.",
+      "default": true
+    },
+    {
+      "id": "attention",
+      "kind": "prompt",
+      "label": "Needs me",
+      "prompt": "Which T3 threads are waiting on an approval or my input? Walk me through each one."
+    }
+  ],
+  "mcp": {
+    "transport": "stdio",
+    "command": "/Applications/T3 Agents.app/Contents/MacOS/T3 Agents",
+    "args": [
+      "/Applications/T3 Agents.app/Contents/Resources/t3-mcp-gateway.mjs"
+    ],
+    "env": {
+      "ELECTRON_RUN_AS_NODE": "1",
+      "T3CODE_HOME": "{{setting.t3Home}}",
+      "T3_MCP_BRIDGE_PORT": "{{setting.bridgePort}}",
+      "T3_MCP_BRIDGE_TOKEN": "{{secret.T3_MCP_BRIDGE_TOKEN}}"
+    }
+  },
+  "secrets": [
+    {
+      "name": "T3_MCP_BRIDGE_TOKEN",
+      "description": "The MCP Gateway bridge token from T3 Settings → MCP Gateway (also saved as T3_MCP_BRIDGE_TOKEN in ~/.config/t3code/mcp-gateway.env)."
+    }
+  ],
+  "settings": [
+    {
+      "id": "environmentId",
+      "label": "Environment ID",
+      "type": "text",
+      "required": true,
+      "description": "The T3 environment the phone widget shows (t3_list_environments lists them). The execution agent can reach every environment the gateway grants."
+    },
+    {
+      "id": "t3Home",
+      "label": "T3 data folder",
+      "type": "text",
+      "required": true,
+      "format": "directory",
+      "description": "The folder T3 Agents keeps its data in, usually ~/.t3 (absolute path). The gateway must use the same state as the running T3 app."
+    },
+    {
+      "id": "bridgePort",
+      "label": "Bridge port",
+      "type": "text",
+      "default": "47631",
+      "description": "T3 Settings → MCP Gateway → bridge port. Change only if you changed it in T3."
+    }
+  ],
+  "permissions": {
+    "tools": [
+      {
+        "name": "t3_get_agents_view",
+        "access": "read"
+      },
+      {
+        "name": "t3_get_approval_plan",
+        "access": "read"
+      },
+      {
+        "name": "t3_get_artifact",
+        "access": "read"
+      },
+      {
+        "name": "t3_get_diff",
+        "access": "read"
+      },
+      {
+        "name": "t3_get_environment_health",
+        "access": "read"
+      },
+      {
+        "name": "t3_get_environment_status",
+        "access": "read"
+      },
+      {
+        "name": "t3_get_gateway_health",
+        "access": "read"
+      },
+      {
+        "name": "t3_get_messages",
+        "access": "read"
+      },
+      {
+        "name": "t3_get_operation_history",
+        "access": "read"
+      },
+      {
+        "name": "t3_get_pr",
+        "access": "read"
+      },
+      {
+        "name": "t3_get_pr_checks",
+        "access": "read"
+      },
+      {
+        "name": "t3_get_thread",
+        "access": "read"
+      },
+      {
+        "name": "t3_get_thread_history",
+        "access": "read"
+      },
+      {
+        "name": "t3_git_status",
+        "access": "read"
+      },
+      {
+        "name": "t3_list_agents",
+        "access": "read"
+      },
+      {
+        "name": "t3_list_artifacts",
+        "access": "read"
+      },
+      {
+        "name": "t3_list_environments",
+        "access": "read"
+      },
+      {
+        "name": "t3_list_projects",
+        "access": "read"
+      },
+      {
+        "name": "t3_list_review_comments",
+        "access": "read"
+      },
+      {
+        "name": "t3_list_skills",
+        "access": "read"
+      },
+      {
+        "name": "t3_list_threads",
+        "access": "read"
+      },
+      {
+        "name": "t3_summarize_thread",
+        "access": "read"
+      },
+      {
+        "name": "t3_wait_for_thread_status",
+        "access": "read"
+      },
+      {
+        "name": "t3_apply_patch",
+        "access": "write"
+      },
+      {
+        "name": "t3_apply_review_fixes",
+        "access": "write"
+      },
+      {
+        "name": "t3_approve_actions",
+        "access": "write"
+      },
+      {
+        "name": "t3_cancel_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_commit_changes",
+        "access": "write"
+      },
+      {
+        "name": "t3_control_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_create_agent",
+        "access": "write"
+      },
+      {
+        "name": "t3_create_and_start_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_create_branch",
+        "access": "write"
+      },
+      {
+        "name": "t3_create_pr",
+        "access": "write"
+      },
+      {
+        "name": "t3_create_skill",
+        "access": "write"
+      },
+      {
+        "name": "t3_create_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_delete_agent",
+        "access": "write"
+      },
+      {
+        "name": "t3_delete_skill",
+        "access": "write"
+      },
+      {
+        "name": "t3_handoff_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_modify_actions",
+        "access": "write"
+      },
+      {
+        "name": "t3_open_agents",
+        "access": "write"
+      },
+      {
+        "name": "t3_open_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_pause_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_publish_pr",
+        "access": "write"
+      },
+      {
+        "name": "t3_reject_actions",
+        "access": "write"
+      },
+      {
+        "name": "t3_reply_review_comment",
+        "access": "write"
+      },
+      {
+        "name": "t3_respond_to_approval",
+        "access": "write"
+      },
+      {
+        "name": "t3_restart_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_resume_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_retry_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_send_message",
+        "access": "write"
+      },
+      {
+        "name": "t3_settle_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_stop_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_unsettle_thread",
+        "access": "write"
+      },
+      {
+        "name": "t3_update_agent",
+        "access": "write"
+      },
+      {
+        "name": "t3_update_pr",
+        "access": "write"
+      },
+      {
+        "name": "t3_update_skill",
+        "access": "write"
+      }
+    ]
+  },
+  "data": [
+    {
+      "id": "active",
+      "tool": "t3_list_threads",
+      "arguments": {
+        "environmentId": "{{setting.environmentId}}",
+        "state": "active"
+      },
+      "extract": "text-json",
+      "refreshSeconds": 10
+    },
+    {
+      "id": "running",
+      "tool": "t3_list_threads",
+      "arguments": {
+        "environmentId": "{{setting.environmentId}}",
+        "executionState": "running"
+      },
+      "extract": "text-json",
+      "refreshSeconds": 10
+    },
+    {
+      "id": "approvals",
+      "tool": "t3_list_threads",
+      "arguments": {
+        "environmentId": "{{setting.environmentId}}",
+        "executionState": "waiting-approval"
+      },
+      "extract": "text-json",
+      "refreshSeconds": 10
+    },
+    {
+      "id": "input",
+      "tool": "t3_list_threads",
+      "arguments": {
+        "environmentId": "{{setting.environmentId}}",
+        "executionState": "waiting-input"
+      },
+      "extract": "text-json",
+      "refreshSeconds": 10
+    }
+  ],
+  "glance": {
+    "stats": [
+      {
+        "label": "Running",
+        "value": "{{running/data/items|count}}",
+        "tone": "info"
+      },
+      {
+        "label": "Approvals",
+        "value": "{{approvals/data/items|count}}",
+        "tone": "warning"
+      }
+    ]
+  },
+  "blocks": [
+    {
+      "type": "stats",
+      "items": [
+        {
+          "label": "Running",
+          "value": "{{running/data/items|count}}",
+          "tone": "info"
+        },
+        {
+          "label": "Approvals",
+          "value": "{{approvals/data/items|count}}",
+          "tone": "warning"
+        },
+        {
+          "label": "Questions",
+          "value": "{{input/data/items|count}}",
+          "tone": "warning"
+        }
+      ]
+    },
+    {
+      "type": "list",
+      "items": "{{active/data/items|sort:pinOrderKey,-pinnedAt,-hasPendingApprovals,-hasPendingUserInput,-status=running,-updatedAt}}",
+      "item": {
+        "title": "{{item/title|truncate:60}}",
+        "subtitle": "{{item/profileSnapshot/profileName|default:T3}}",
+        "status": "{{item/status}}",
+        "statusTones": {
+          "running": "info",
+          "queued": "info",
+          "waiting-approval": "warning",
+          "waiting-input": "warning",
+          "completed": "success",
+          "failed": "danger",
+          "interrupted": "danger",
+          "stopped": "neutral",
+          "idle": "neutral"
+        },
+        "key": "{{item/id}}"
+      },
+      "limit": 8,
+      "emptyText": "No active threads"
+    }
+  ],
+  "detail": {
+    "tool": "t3_get_messages",
+    "arguments": {
+      "environmentId": "{{setting.environmentId}}",
+      "threadId": "{{item/id}}",
+      "limit": 20
+    },
+    "extract": "text-json",
+    "messages": "{{detail/data/items}}",
+    "message": {
+      "role": "{{item/role}}",
+      "text": "{{item/text}}",
+      "at": "{{item/createdAt}}"
+    }
+  },
+  "notify": [
+    {
+      "id": "threads",
+      "category": "agents",
+      "items": "{{active/data/items}}",
+      "key": "{{item/id}}",
+      "state": "{{item/status}}",
+      "rules": [
+        {
+          "state": "completed",
+          "priority": "finished",
+          "text": "“{{item/title}}” ({{item/profileSnapshot/profileName|default:T3}}) finished.",
+          "withLatest": true
+        },
+        {
+          "state": "failed",
+          "priority": "failed",
+          "text": "“{{item/title}}” ({{item/profileSnapshot/profileName|default:T3}}) failed.",
+          "withLatest": true
+        },
+        {
+          "state": "interrupted",
+          "priority": "failed",
+          "text": "“{{item/title}}” ({{item/profileSnapshot/profileName|default:T3}}) was interrupted.",
+          "withLatest": true
+        },
+        {
+          "state": "waiting-approval",
+          "priority": "needs_you",
+          "text": "“{{item/title}}” ({{item/profileSnapshot/profileName|default:T3}}) is waiting for your approval.",
+          "withLatest": true
+        },
+        {
+          "state": "waiting-input",
+          "priority": "needs_you",
+          "text": "“{{item/title}}” ({{item/profileSnapshot/profileName|default:T3}}) has a question for you.",
+          "withLatest": true
+        }
+      ]
+    },
+    {
+      "id": "approvals",
+      "category": "agents",
+      "items": "{{active/data/items}}",
+      "key": "{{item/id}}",
+      "state": "{{item/hasPendingApprovals}}",
+      "rules": [
+        {
+          "state": "true",
+          "priority": "needs_you",
+          "text": "“{{item/title}}” ({{item/profileSnapshot/profileName|default:T3}}) is waiting for your approval.",
+          "withLatest": true
+        }
+      ]
+    },
+    {
+      "id": "questions",
+      "category": "agents",
+      "items": "{{active/data/items}}",
+      "key": "{{item/id}}",
+      "state": "{{item/hasPendingUserInput}}",
+      "rules": [
+        {
+          "state": "true",
+          "priority": "needs_you",
+          "text": "“{{item/title}}” ({{item/profileSnapshot/profileName|default:T3}}) has a question for you.",
+          "withLatest": true
+        }
+      ]
+    }
+  ]
+}

package/packs/telegram/pack.json

@@ -0,0 +1,137 @@
+{
+  "$schema": "../../../../docs/schemas/pack-v1.schema.json",
+  "schemaVersion": 1,
+  "id": "dev.remotevoiceagent.telegram",
+  "name": "Telegram",
+  "description": "Your Telegram account through chigwell/telegram-mcp, launched read-only. Unread chats on the phone, alerts when a chosen contact has unread messages, and chat reading and search.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Sidebud"
+  },
+  "license": "MIT",
+  "logo": {
+    "kind": "icon",
+    "name": "chat"
+  },
+  "tile": {
+    "size": "small"
+  },
+  "mcp": {
+    "transport": "stdio",
+    "command": "uv",
+    "args": [
+      "--directory",
+      "{{setting.serverDir}}",
+      "run",
+      "main.py"
+    ],
+    "env": {
+      "TELEGRAM_API_ID": "{{secret.TELEGRAM_API_ID}}",
+      "TELEGRAM_API_HASH": "{{secret.TELEGRAM_API_HASH}}",
+      "TELEGRAM_SESSION_STRING": "{{secret.TELEGRAM_SESSION_STRING}}",
+      "TELEGRAM_EXPOSED_TOOLS": "read-only",
+      "MCP_TRANSPORT": "stdio"
+    }
+  },
+  "secrets": [
+    {
+      "name": "TELEGRAM_API_ID",
+      "description": "From my.telegram.org → API development tools"
+    },
+    {
+      "name": "TELEGRAM_API_HASH",
+      "description": "From my.telegram.org → API development tools"
+    },
+    {
+      "name": "TELEGRAM_SESSION_STRING",
+      "description": "Made once with the server's session_string_generator.py; it grants full account access, so it stays in the keychain"
+    }
+  ],
+  "permissions": {
+    "tools": [
+      {
+        "name": "list_chats",
+        "access": "read",
+        "description": "Chats and unread counts"
+      },
+      {
+        "name": "list_messages",
+        "access": "read",
+        "description": "Messages in one chat"
+      },
+      {
+        "name": "search_messages",
+        "access": "read",
+        "description": "Search one chat"
+      }
+    ]
+  },
+  "settings": [
+    {
+      "id": "serverDir",
+      "label": "telegram-mcp folder",
+      "type": "text",
+      "default": "",
+      "description": "Absolute path to a clone of chigwell/telegram-mcp (installed with uv)."
+    }
+  ],
+  "data": [
+    {
+      "id": "unread",
+      "tool": "list_chats",
+      "arguments": {
+        "unread_only": true,
+        "limit": 20
+      },
+      "extract": "text-json",
+      "refreshSeconds": 30
+    }
+  ],
+  "glance": {
+    "stats": [
+      {
+        "label": "Unread chats",
+        "value": "{{unread/results|count}}",
+        "tone": "info"
+      }
+    ]
+  },
+  "badge": {
+    "text": "{{unread/results|count}}",
+    "tone": "info"
+  },
+  "blocks": [
+    {
+      "type": "list",
+      "items": "{{unread/results}}",
+      "item": {
+        "title": "{{item/title}}{{item/name}}",
+        "status": "{{item/unread}}"
+      },
+      "limit": 8,
+      "emptyText": "No unread chats"
+    }
+  ],
+  "controls": [
+    {
+      "id": "summarize",
+      "kind": "prompt",
+      "label": "Summarize Telegram",
+      "prompt": "Which Telegram chats have unread messages, and what do they say?",
+      "default": true
+    }
+  ],
+  "alerts": [
+    {
+      "id": "unread",
+      "items": "{{unread/results}}",
+      "key": "{{item/chat_id}}:{{item/unread}}",
+      "sender": [
+        "{{item/username}}",
+        "{{item/title}}",
+        "{{item/name}}"
+      ],
+      "text": "{{item/unread}} unread message(s)"
+    }
+  ]
+}