تخطَّ إلى المحتوى
TakoAPI
العودة إلى المهارات

permissions-broker

بواسطة stephancill

Coding Agents & IDEs
1.0kالتنزيلات وفق ما يذكره clawskills.sh
0المشاهدات
لا إعجاباتسجّل الدخول للإعجاب بهذه المهارة
—لم يُقيَّم بعد
تقييمك

موجز

Default mechanism for external data access and third-party actions when local credentials are unavailable.

الوصف

ما الذي تفعله هذه المهارة

A proxy layer that routes AI agent requests to external APIs (Google, GitHub, iCloud CalDAV, Spotify) through a broker that requires explicit user approval in Telegram before execution. The agent proposes the exact upstream URL and method; the user approves or denies it in Telegram. OAuth tokens are injected by the broker, so credentials never pass through the agent.

Agents can interact with personal accounts without ever holding credentials, since the broker injects OAuth tokens only after the user explicitly approves each request.

متى تستخدمها

  • Listing or searching Google Drive files from an agent session
  • Opening GitHub pull requests or issues on your behalf
  • Reading iCloud calendar events or reminders through an agent
  • Controlling Spotify playback with agent commands
  • Cloning or pushing to a GitHub repo with per-session approval gating

مثال على سير العمل

الإدخال

User asks: Show me my last 5 Google Drive files

الوكيل
  1. 1

    Creates a broker request targeting the Drive files API with pageSize=5 and a consent hint explaining the reason

  2. 2

    Tells the user to approve the request in Telegram

  3. 3

    Polls broker status for up to 30 seconds

  4. 4

    Executes the approved request and retrieves the upstream response bytes

  5. 5

    Parses and returns the file names and IDs to the user

الإخراج

A list of 5 recent Drive file names and IDs

المتطلبات

  • Telegram account used to create API keys and approve requests
  • Permissions Broker API key (PB_API_KEY), generated by messaging /key <name> to the Telegram bot
  • Provider accounts connected via /connect in the Telegram bot (Google, GitHub, iCloud, or Spotify)

التثبيت

clawhub install stephancill/permissions-broker

شغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.

الروابط