@muxoai/platform 1.4.1 → 1.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/.agents/plugins/marketplace.json +1 -1
  2. package/.claude-plugin/marketplace.json +2 -2
  3. package/README.md +1 -1
  4. package/dist/cli.js +94 -3
  5. package/dist/composio-catalog.d.ts +177 -1
  6. package/dist/composio-catalog.js +1427 -7
  7. package/dist/config.d.ts +6 -0
  8. package/dist/config.js +11 -1
  9. package/dist/durable-workflow.d.ts +71 -4
  10. package/dist/durable-workflow.js +199 -5
  11. package/dist/engine.d.ts +82 -3
  12. package/dist/engine.js +406 -41
  13. package/dist/index.d.ts +3 -0
  14. package/dist/index.js +3 -0
  15. package/dist/mcp-schema.d.ts +162 -1
  16. package/dist/mcp-schema.js +1544 -40
  17. package/dist/mcp.d.ts +2 -2
  18. package/dist/mcp.js +474 -26
  19. package/dist/memory-graph.d.ts +26 -2
  20. package/dist/memory-graph.js +127 -7
  21. package/dist/oss-suite.d.ts +217 -0
  22. package/dist/oss-suite.js +836 -0
  23. package/dist/policy.d.ts +108 -1
  24. package/dist/policy.js +406 -1
  25. package/dist/providers/composio-instant.js +38 -3
  26. package/dist/providers/composio-sdk.d.ts +59 -2
  27. package/dist/providers/composio-sdk.js +273 -59
  28. package/dist/providers/stripe-projects.d.ts +4 -0
  29. package/dist/providers/stripe-projects.js +548 -126
  30. package/dist/sdk.d.ts +24 -1
  31. package/dist/sdk.js +53 -2
  32. package/dist/server.js +659 -64
  33. package/dist/store.js +2 -0
  34. package/dist/types.d.ts +34 -1
  35. package/dist/ui/console-html.d.ts +31 -1
  36. package/dist/ui/console-html.js +922 -368
  37. package/dist/ui/design-tokens.js +1 -1
  38. package/dist/version.d.ts +1 -1
  39. package/dist/version.js +1 -1
  40. package/package.json +3 -2
  41. package/plugins/muxo/.claude-plugin/plugin.json +2 -2
  42. package/plugins/muxo/.codex-plugin/plugin.json +15 -8
  43. package/plugins/muxo/.cursor-plugin/plugin.json +30 -0
  44. package/plugins/muxo/hooks/session-start.sh +15 -3
  45. package/plugins/muxo/hooks/user-prompt-submit.sh +14 -1
  46. package/plugins/muxo/mcp.json +0 -10
  47. package/plugins/muxo/plugin.json +4 -4
  48. package/plugins/muxo/skills/muxo/SKILL.md +25 -16
  49. package/plugins/muxo/skills/muxo/references/cli.md +5 -1
  50. package/plugins/muxo/skills/muxo/references/mcp.md +11 -6
  51. package/plugins/muxo/skills/muxo-activity-summary/SKILL.md +81 -0
  52. package/plugins/muxo/skills/setup/SKILL.md +1 -1
  53. package/src/catalogues/stripe-projects-catalog.json +140 -0
@@ -167,7 +167,7 @@ a{color:var(--color-accent);text-underline-offset:4px}
167
167
  @media(prefers-reduced-motion:reduce){*,*::before,*::after{animation:none!important;transition:none!important;scroll-behavior:auto!important}}
168
168
  `;
169
169
  /** Runs before first paint so the saved theme never flashes. */
170
- export const muxoThemeBootstrap = `(function(){var t=null;try{t=localStorage.getItem("${THEME_STORAGE_KEY}")}catch(e){}var d=t==="dark"?"dark":"light";document.documentElement.dataset.theme=d;var m=document.querySelector('meta[name="theme-color"]');if(m)m.setAttribute("content",d==="dark"?"${muxoThemes.dark.bg}":"${muxoThemes.light.bg}");})();`;
170
+ export const muxoThemeBootstrap = `(function(){var t=null;try{t=localStorage.getItem("${THEME_STORAGE_KEY}")}catch(e){}var d=t==="light"?"light":"dark";document.documentElement.dataset.theme=d;var m=document.querySelector('meta[name="theme-color"]');if(m)m.setAttribute("content",d==="dark"?"${muxoThemes.dark.bg}":"${muxoThemes.light.bg}");})();`;
171
171
  /** Muxo's own mark (same markup as web/vendor/packages/runtime/src/brand.ts). */
172
172
  export const muxoMark = `<svg viewBox="0 0 24 24" fill="none" aria-hidden="true" focusable="false"><g stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M2 5h6l7 7"/><path d="M2 12h13"/><path d="M2 19h6l7-7"/><path d="M15 12h4"/></g><rect x="19" y="10" width="4" height="4" rx="1" fill="var(--color-button-primary, #0071e3)"/></svg>`;
173
173
  export const iconPaths = {
package/dist/version.d.ts CHANGED
@@ -1 +1 @@
1
- export declare const MUXO_VERSION = "1.4.1";
1
+ export declare const MUXO_VERSION = "1.4.3";
package/dist/version.js CHANGED
@@ -1 +1 @@
1
- export const MUXO_VERSION = "1.4.1";
1
+ export const MUXO_VERSION = "1.4.3";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@muxoai/platform",
3
- "version": "1.4.1",
3
+ "version": "1.4.3",
4
4
  "description": "Muxo — Unified Execution, Provisioning & Governance Platform over Composio, Stripe Projects, Microsoft Agent Governance & Supermemory",
5
5
  "private": false,
6
6
  "license": "MIT",
@@ -57,7 +57,8 @@
57
57
  "dev": "tsx watch src/server.ts",
58
58
  "cli": "tsx src/cli.ts",
59
59
  "mcp": "tsx src/cli.ts mcp",
60
- "test": "node --no-warnings --import tsx --test tests/*.test.ts"
60
+ "test": "node --no-warnings --import tsx --test tests/*.test.ts",
61
+ "test:browser": "node --no-warnings --import tsx --test tests/browser-cli-harness.test.ts"
61
62
  },
62
63
  "engines": {
63
64
  "node": ">=22.0.0"
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "name": "muxo",
3
- "version": "1.4.1",
3
+ "version": "1.4.3",
4
4
  "description": "Governed agent execution across 1,000+ Connected Apps (managed OAuth handoff), Instant Tools (search, scrape, crawl, SEO audit), live Cloud Infrastructure provisioning, Workspace Memory recall, and verifiable audit records.",
5
5
  "author": {
6
- "name": "Muxo",
6
+ "name": "Muxo AI LLC",
7
7
  "email": "founders@muxo.ai",
8
8
  "url": "https://muxo.ai"
9
9
  },
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "name": "muxo",
3
- "version": "1.4.1",
4
- "description": "Your agent decides what to do — Muxo governs, provisions, remembers, and executes it. Unified access to 1,000+ Connected Apps (managed OAuth handoff), Instant Tools (search, scrape, crawl, SEO audit), live Cloud Infrastructure provisioning (Postgres, Redis, SQLite, Storage), Workspace Memory recall, and verifiable audit records through the hosted app or local CLI.",
3
+ "version": "1.4.3",
4
+ "description": "Your agent decides what to do — Muxo governs, provisions, remembers, and executes it. Unified access to 1,000+ Connected Apps (managed OAuth handoff), Instant Tools (search, scrape, crawl, SEO audit), live Cloud Infrastructure provisioning (Postgres, Redis, SQLite, Storage), Workspace Memory recall, and verifiable audit records.",
5
5
  "author": {
6
- "name": "Muxo",
6
+ "name": "Muxo AI LLC",
7
7
  "email": "founders@muxo.ai",
8
8
  "url": "https://muxo.ai"
9
9
  },
@@ -29,12 +29,19 @@
29
29
  "skills": "./skills/",
30
30
  "mcpServers": "./.mcp.json",
31
31
  "apps": "./.app.json",
32
- "onboardingSkill": "./skills/setup/SKILL.md",
32
+ "extensions": {
33
+ "com.openai": {
34
+ "onboardingSkill": "./skills/setup/SKILL.md",
35
+ "publication": {
36
+ "release_notes": "Muxo v1.4.3: Unified governed execution across 1,000+ Connected Apps, Instant web/SEO tools, 94 Stripe Projects Cloud Infrastructure services, MCP 2026-07-28 compliance, and Workspace Memory."
37
+ }
38
+ }
39
+ },
33
40
  "interface": {
34
41
  "displayName": "Muxo",
35
42
  "shortDescription": "Governed SaaS, cloud & memory",
36
- "longDescription": "Discover, plan, authorize via OAuth handoff, and execute governed actions across 1,000+ Connected Apps (GitHub, Gmail, Slack, Notion, Linear), Instant Tools (web search, scrape, multi-page crawl, technical SEO audit), and live Cloud Infrastructure (Neon Postgres, Turso SQLite, Supabase, Cloudflare, Vercel) with Workspace Memory recall and verifiable audit logs.",
37
- "developerName": "Muxo",
43
+ "longDescription": "Discover, plan, authorize via OAuth handoff, and execute governed actions across 1,000+ Connected Apps (GitHub, Gmail, Slack, Notion, Linear), Instant Tools (web search, scrape, multi-page crawl, technical SEO audit), and live Cloud Infrastructure (Turso SQLite, Neon Postgres, Supabase, Upstash Redis, Resend) with Workspace Memory recall and verifiable audit logs.",
44
+ "developerName": "Muxo AI LLC",
38
45
  "category": "Productivity",
39
46
  "capabilities": [
40
47
  "Interactive",
@@ -46,8 +53,8 @@
46
53
  "termsOfServiceURL": "https://muxo.ai/terms",
47
54
  "defaultPrompt": [
48
55
  "Audit https://muxo.ai for technical SEO and crawl its top pages.",
49
- "Connect my GitHub or Gmail account and open a tracking issue for our next release.",
50
- "Provision a free Turso SQLite database and pull the credentials into .env.muxo."
56
+ "Connect my Gmail or GitHub account via OAuth handoff and fetch recent items.",
57
+ "Provision a Turso SQLite database and store its connection secrets in the Muxo Vault."
51
58
  ],
52
59
  "composerIcon": "./assets/logo.png",
53
60
  "logo": "./assets/logo.png",
@@ -0,0 +1,30 @@
1
+ {
2
+ "name": "muxo",
3
+ "description": "Your agent decides what to do — Muxo governs, provisions, remembers, and executes it. Connect and operate 1,000+ external apps via managed OAuth, zero-auth Instant Tools (web search, scrape, crawl, SEO audit, remote workbench), live Cloud Infrastructure provisioning (Stripe Projects), and Workspace Memory from Cursor.",
4
+ "version": "1.4.3",
5
+ "mcpServers": "../mcp.json",
6
+ "skills": "../skills/",
7
+ "author": {
8
+ "name": "Muxo AI LLC",
9
+ "email": "founders@muxo.ai",
10
+ "url": "https://muxo.ai"
11
+ },
12
+ "homepage": "https://muxo.ai",
13
+ "repository": "https://github.com/muxo-ai/muxo",
14
+ "license": "MIT",
15
+ "keywords": [
16
+ "muxo",
17
+ "mcp",
18
+ "cursor",
19
+ "composio",
20
+ "stripe-projects",
21
+ "integrations",
22
+ "oauth",
23
+ "infrastructure",
24
+ "governance",
25
+ "supermemory",
26
+ "automation",
27
+ "productivity"
28
+ ],
29
+ "logo": "../assets/logo.svg"
30
+ }
@@ -23,10 +23,22 @@ if (command -v muxo >/dev/null 2>&1 || [ -f "$REPO_CLI" ]); then
23
23
  (
24
24
  tmp="$(mktemp "${CACHE}.XXXXXX" 2>/dev/null)" || exit 0
25
25
  printf '%s\n' \
26
- github gmail slack notion linear jira hubspot calendar stripe \
27
- neon supabase turso upstash cloudflare vercel prisma mongodb \
28
- hackernews dns supermemory governance >"$tmp" 2>/dev/null
26
+ github gmail slack notion linear jira hubspot calendar googlecalendar \
27
+ discord googledrive airtable salesforce zendesk shopify pagerduty sentry \
28
+ stripe neon supabase turso upstash cloudflare vercel prisma mongodb \
29
+ planetscale clickhouse chroma clerk workos auth0 resend posthog datadog \
30
+ inngest railway flyio render netlify herenow e2b daytona browserbase steel \
31
+ exa firecrawl perplexity openrouter elevenlabs cloudinary agentmail twilio \
32
+ hackernews dns seo crawl scrape workbench supermemory governance guardrail receipt >"$tmp" 2>/dev/null
33
+ if command -v jq >/dev/null 2>&1; then
34
+ ( run_muxo search "" --json 2>/dev/null \
35
+ | jq -r '(.tools // .)[]? | .provider // empty, .slug // empty' \
36
+ | tr '[:upper:]._' '[:lower:]\n\n' >>"$tmp" 2>/dev/null ) &
37
+ fpid=$!
38
+ wait "$fpid" 2>/dev/null || true
39
+ fi
29
40
  if [ -s "$tmp" ]; then
41
+ sort -u "$tmp" >"${tmp}.u" 2>/dev/null && mv -f "${tmp}.u" "$tmp" 2>/dev/null || true
30
42
  mv -f "$tmp" "$CACHE" 2>/dev/null || rm -f "$tmp" 2>/dev/null
31
43
  else
32
44
  rm -f "$tmp" 2>/dev/null
@@ -32,7 +32,20 @@ done <"$CACHE"
32
32
 
33
33
  [ "$matched" -eq 1 ] || exit 0
34
34
 
35
- line="You mentioned a SaaS app, cloud infrastructure provider, or memory/governance operation that Muxo governs. Prefer the local Muxo CLI (\`muxo search\`, \`muxo link <provider> --wait\`, \`muxo exec\`, \`muxo env pull\`) in terminal sessions, or use callable hosted Muxo MCP tools (\`search_tools\`, \`plan_action\`, \`start_connection\`, \`wait_for_connection\`, \`execute_*\`) when in hosted mode. Never replay an uncertain write or provisioning call through the other surface."
35
+ lane_hint=""
36
+ case "$norm" in
37
+ *" turso "*|*" neon "*|*" supabase "*|*" upstash "*|*" vercel "*|*" cloudflare "*|*" netlify "*|*" render "*|*" railway "*|*" flyio "*|*" clerk "*|*" workos "*|*" resend "*)
38
+ lane_hint=" For Stripe Projects cloud infrastructure (\`resource.*\`), provision directly via \`muxo exec resource.<provider>.<service> --approve\` or MCP \`plan_action\` + \`execute_provisioning\` (never use OAuth handoff for \`resource.*\`)."
39
+ ;;
40
+ *" seo "*|*" crawl "*|*" scrape "*|*" dns "*|*" hackernews "*|*" workbench "*)
41
+ lane_hint=" For zero-OAuth Composio Instant tools (\`instant.*\`), run directly via \`muxo exec instant.<tool>\` or MCP \`plan_action\` + \`execute_read\`."
42
+ ;;
43
+ *" github "*|*" gmail "*|*" slack "*|*" notion "*|*" linear "*|*" jira "*|*" hubspot "*|*" calendar "*|*" googlecalendar "*|*" discord "*|*" airtable "*|*" salesforce "*)
44
+ lane_hint=" For Connected Apps (\`app.*\`), use \`muxo link <provider> --wait\` or MCP \`start_connection\` + \`wait_for_connection\` if OAuth handoff is required."
45
+ ;;
46
+ esac
47
+
48
+ line="You mentioned a SaaS app, zero-OAuth Instant tool, cloud infrastructure provider, or memory/governance operation that Muxo governs. Prefer the local Muxo CLI (\`muxo do \"<instruction>\"\`, \`muxo search\`, \`muxo link <provider> --wait\`, \`muxo exec\`, \`muxo env pull\`) in terminal sessions, or use callable hosted Muxo MCP tools (\`search_tools\`, \`plan_action\`, \`start_connection\`, \`wait_for_connection\`, \`execute_*\`) when in hosted mode.${lane_hint} Never replay an uncertain write or provisioning call through the other surface."
36
49
 
37
50
  if command -v jq >/dev/null 2>&1; then
38
51
  jq -n --arg c "$line" \
@@ -4,16 +4,6 @@
4
4
  "muxo": {
5
5
  "type": "streamable-http",
6
6
  "url": "https://api.muxo.ai/mcp",
7
- "oauth": {
8
- "clientId": "muxo-openai-plugin",
9
- "callbackPort": 3118,
10
- "scopes": [
11
- "muxo:mcp",
12
- "muxo:read",
13
- "muxo:execute",
14
- "muxo:provision"
15
- ]
16
- },
17
7
  "extensions": {
18
8
  "com.openai": {
19
9
  "auth": {
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
3
  "name": "muxo",
4
- "version": "1.4.1",
4
+ "version": "1.4.3",
5
5
  "description": "Your agent decides what to do — Muxo governs, provisions, remembers, and executes it. Unified access to 1,000+ Connected Apps (managed OAuth handoff), Instant Tools (search, scrape, crawl, SEO audit), live Cloud Infrastructure provisioning (Postgres, Redis, SQLite, Storage), Workspace Memory recall, and verifiable audit records.",
6
6
  "author": {
7
- "name": "Muxo",
7
+ "name": "Muxo AI LLC",
8
8
  "email": "founders@muxo.ai",
9
9
  "url": "https://muxo.ai"
10
10
  },
@@ -35,7 +35,7 @@
35
35
  "displayName": "Muxo",
36
36
  "shortDescription": "Governed SaaS, cloud & memory",
37
37
  "longDescription": "Discover, plan, authorize via OAuth handoff, and execute governed actions across 1,000+ Connected Apps (GitHub, Gmail, Slack, Notion, Linear), Instant Tools (web search, scrape, multi-page crawl, technical SEO audit), and live Cloud Infrastructure (Turso SQLite, Neon Postgres, Supabase, Upstash Redis, Resend) with Workspace Memory recall and verifiable audit logs.",
38
- "developerName": "Muxo",
38
+ "developerName": "Muxo AI LLC",
39
39
  "category": "Productivity",
40
40
  "capabilities": [
41
41
  "Interactive",
@@ -109,7 +109,7 @@
109
109
  "commerce_description": "This plugin does not sell retail products or process consumer checkout inside ChatGPT."
110
110
  },
111
111
  "publication": {
112
- "release_notes": "Muxo v1.4.1: Unified governed execution across 1,000+ Connected Apps, Instant web/SEO tools, Cloud Infrastructure provisioning, and Workspace Memory."
112
+ "release_notes": "Muxo v1.4.3: Unified governed execution across 1,000+ Connected Apps, Instant web/SEO tools, 94 Stripe Projects Cloud Infrastructure services, MCP 2026-07-28 compliance, and Workspace Memory."
113
113
  }
114
114
  }
115
115
  }
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: muxo
3
- description: Route governed Muxo work through the hosted Muxo MCP server (`https://api.muxo.ai/mcp`), the live Muxo HTTP API (`https://api.muxo.ai`), or the local Muxo CLI. Use when a user wants to read or act on external SaaS services via Composio Connected Apps (GitHub, Gmail, Slack, Notion, Linear, Jira, HubSpot, Google Calendar, Google Drive, Discord, Airtable, Salesforce, and 1,000+ apps), complete OAuth handoff (`start_connection`, `wait_for_connection`, `connection_status`), provision live cloud infrastructure via Stripe Projects (`resource.*` for Turso SQLite, Neon Postgres, Supabase, Upstash Redis, Cloudflare Workers, Vercel, Prisma, Clerk, WorkOS, PlanetScale, ClickHouse, Chroma, E2B, Browserbase, Resend, Sentry, PostHog, Datadog, Railway, Fly.io), manage Stripe credits & subscriptions (`billing.*`), run zero-OAuth Instant tools (`instant.*` for web search, scrape, crawl, SEO audit, DNS, Hacker News), recall workspace context from Muxo Workspace Memory, or verify cryptographic execution receipts.
3
+ description: "Route governed Muxo work through the hosted Muxo MCP server, the live Muxo HTTPS API, or the local Muxo CLI. Use when a user wants to read or act on external SaaS services via Connected Apps (GitHub, Gmail, Slack, Notion, Linear, Jira, HubSpot, Google Calendar, Discord, Airtable, Salesforce, and 1,000+ apps), complete OAuth handoff, provision live cloud infrastructure (Turso SQLite, Neon Postgres, Supabase, Upstash Redis, Resend), run zero-OAuth Instant tools (web search, scrape, crawl, SEO audit, DNS, Hacker News), recall Workspace Memory, or verify cryptographic execution receipts."
4
4
  ---
5
5
 
6
6
  # Muxo
@@ -14,7 +14,7 @@ Choose the execution surface available in the current session, and NEVER check f
14
14
  - If these MCP tools are present in the session, call them directly! Do NOT run bash commands to check if `muxo` CLI is installed first. Read [references/mcp.md](references/mcp.md).
15
15
  2. **Direct HTTPS API / JSON-RPC Fallback (when inside ChatGPT/sandbox with `curl` or Python/fetch access, and MCP tools are not bound in the session)**:
16
16
  - If the user installed the skill without connecting the MCP server at `https://chatgpt.com/plugins`, you can STILL execute every Muxo tool live over HTTPS against `https://api.muxo.ai/mcp` or `https://api.muxo.ai/api/v1/do`!
17
- - Works for **Zero-OAuth Instant Tools (`instant.*`)**, **Composio Connected Apps & OAuth Handoff (`app.*`, `start_connection`, `wait_for_connection`)**, and **Stripe Projects Cloud Provisioning & Billing (`resource.*`, `billing.*`)**.
17
+ - Works for **Zero-OAuth Instant Tools (`instant.*`)**, **Muxo Connected Apps & OAuth Handoff (`app.*`, `start_connection`, `wait_for_connection`)**, and **Stripe Projects Cloud Provisioning & Billing (`resource.*`, `billing.*`)**.
18
18
  - Example one-shot JSON-RPC calls over HTTPS:
19
19
  ```bash
20
20
  # 1) Zero-OAuth Instant Tool (e.g. SEO Audit or Multi-Page Web Crawl)
@@ -23,7 +23,7 @@ Choose the execution surface available in the current session, and NEVER check f
23
23
  curl -s -X POST https://api.muxo.ai/mcp -H "Content-Type: application/json" \
24
24
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"execute_read","arguments":{"plan_id":"<PLAN_ID>"}}}'
25
25
 
26
- # 2) Composio Connected Apps & External User OAuth Handoff (GitHub, Gmail, Slack, Notion, Linear, etc.)
26
+ # 2) Muxo Connected Apps & External User OAuth Handoff (GitHub, Gmail, Slack, Notion, Linear, etc.)
27
27
  curl -s -X POST https://api.muxo.ai/mcp -H "Content-Type: application/json" \
28
28
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"start_connection","arguments":{"provider":"gmail"}}}'
29
29
  # Share connection.redirectUrl with the user, then verify connection status:
@@ -49,6 +49,8 @@ Choose the execution surface available in the current session, and NEVER check f
49
49
  Add a Git repository or local marketplace directory containing `.agents/plugins/marketplace.json` and enable `[plugins."muxo@muxo"]` in `.codex/config.toml`, or configure `[mcp_servers.muxo]` (`url = "https://api.muxo.ai/mcp"`) in `~/.codex/config.toml`.
50
50
  - **Claude Desktop**:
51
51
  Configure hosted MCP via **Settings → Connectors → Add custom connector** (`https://api.muxo.ai/mcp`), or configure the local stdio server (`npx -y @muxoai/cli@latest mcp`, requires Node.js 22+) in `claude_desktop_config.json`.
52
+ - **Cursor**:
53
+ Install from the Cursor Plugin Marketplace (`/add-plugin muxo`), or add `"muxo": { "url": "https://api.muxo.ai/mcp" }` to `.cursor/mcp.json`.
52
54
 
53
55
  ## Fast-Path Slugs & Workflows across Muxo's 4 Pillars
54
56
 
@@ -56,12 +58,13 @@ Choose the execution surface available in the current session, and NEVER check f
56
58
  - Technical SEO Audit: `instant.seo.audit` — `{"url": "https://muxo.ai"}`
57
59
  - Multi-Page Web Crawl: `instant.web.crawl` — `{"url": "https://muxo.ai", "maxPages": 5}`
58
60
  - Web Page Scrape: `instant.web.scrape` — `{"url": "https://muxo.ai"}`
59
- - Live Web Search: `instant.web.search` — `{"query": "..."}`
61
+ - Live Web Search (Composio Instant): `instant.web.search` — `{"query": "..."}`
62
+ - Composio Remote Workbench (Python sandbox): `instant.composio.workbench` — `{"code_to_execute": "print(2 + 2)", "thought": "Compute summary"}`
60
63
  - DNS Lookup: `instant.dns.lookup` — `{"domain": "muxo.ai", "type": "A"}`
61
64
  - GitHub Repo Intel: `instant.github.repo_intel` — `{"owner": "openai", "repo": "openai-node"}`
62
65
  - Hacker News Top Stories: `instant.hackernews.top_stories` — `{"limit": 5}`
63
66
 
64
- ### 2. Composio Connected Apps & OAuth Handoff (`composio_sdk` → `execute_read` / `execute_write`)
67
+ ### 2. Muxo Connected Apps & OAuth Handoff (`composio_sdk` → `execute_read` / `execute_write`)
65
68
  Supports 1,000+ SaaS toolkits dynamically via `search_tools({ query: "...", lane: "composio_sdk", toolkit: "<app>" })` or any `app.<provider>.<action>` slug:
66
69
  - **Gmail**: `app.gmail.fetch_emails` (`{"query": "is:inbox", "max_results": 5}`, `execute_read`), `app.gmail.send_email` (`{"recipient_email": "...", "subject": "...", "body": "..."}`, `execute_write`)
67
70
  - **GitHub**: `app.github.list_issues` (`{"owner": "...", "repo": "..."}`, `execute_read`), `app.github.create_issue` (`{"owner": "...", "repo": "...", "title": "...", "body": "..."}`, `execute_write`)
@@ -81,10 +84,12 @@ Supports 1,000+ SaaS toolkits dynamically via `search_tools({ query: "...", lane
81
84
  3. Poll `wait_for_connection({ provider: "<provider>" })` (or `connection_status({ provider: "<provider>" })`) until `ready: true` (`status === "active"`).
82
85
  4. Resume the original `plan.id` with `execute_read` or `execute_write`.
83
86
 
84
- ### 3. Stripe Projects Cloud Infrastructure Provisioning (`stripe_projects` → `execute_provisioning`)
85
- Provision live cloud databases, caches, auth, sandboxes, and hosting through Muxo's Stripe Projects catalog; connection strings and API keys are automatically encrypted in the AES-256-GCM Muxo Vault (`envVarKeys`):
87
+ ### 3. Stripe Projects Cloud Infrastructure Provisioning (`stripe_projects` → `execute_provisioning`, Zero OAuth Handoff)
88
+ Provision live cloud databases, caches, auth, sandboxes, and hosting through Muxo's Stripe Projects catalog; connection strings, API keys, and deployment URLs are automatically encrypted in the AES-256-GCM Muxo Vault (`envVarKeys`):
89
+ - **IMPORTANT — Never Use OAuth Handoff for Stripe Projects**: Cloud Infrastructure & Hosting providers (`vercel`, `cloudflare`, `netlify`, `render`, `herenow`, `railway`, `flyio`, `turso`, `neon`, `supabase`, `upstash`, `resend`, `clerk`, `workos`, etc.) are **already connected** via Stripe Projects (`lane: "stripe_projects"`, `requiresAuth: false`). NEVER call `start_connection` or `app.vercel.*` for cloud infrastructure or static site deployment — call `plan_action` with `resource.<provider>.*` and `execute_provisioning` directly!
86
90
  - **Databases & Data**: `resource.turso.database`, `resource.neon.postgres`, `resource.supabase.project`, `resource.upstash.redis`, `resource.prisma.database`, `resource.planetscale.postgresql`, `resource.clickhouse.clickhouse`, `resource.chroma.database`
87
- - **Cloud Hosting & Edge**: `resource.cloudflare.worker`, `resource.vercel.project`, `resource.railway.hosting`, `resource.flyio.app`, `resource.render.static_site`, `resource.netlify.project`, `resource.herenow.hosting`
91
+ - **Cloud Hosting & One-Shot Static Site Deployment**: `resource.cloudflare.worker`, `resource.vercel.project`, `resource.railway.hosting`, `resource.flyio.app`, `resource.render.static_site`, `resource.netlify.project`, `resource.herenow.hosting`
92
+ - Pass `html` (or `files: {"index.html": "<!doctype html>..."}`) directly in `input` to publish a live static site in one shot without OAuth: `{"resource_name": "muxo-landing", "plan": "free", "html": "<!doctype html><html>...</html>"}` → `plan_action` → `execute_provisioning` → returns `liveUrl` & `deploymentUrl` (`https://api.muxo.ai/sites/muxo-landing`).
88
93
  - **Auth & Identity**: `resource.clerk.auth`, `resource.workos.auth`, `resource.auth0.client`
89
94
  - **AI, Search, Browser & Sandboxes**: `resource.e2b.sandboxes`, `resource.daytona.sandbox`, `resource.browserbase.project`, `resource.steel.browser`, `resource.exa.search`, `resource.firecrawl.api`, `resource.perplexity.api`, `resource.openrouter.api`, `resource.supermemory.memory`, `resource.elevenlabs.tts`
90
95
  - **Email, Comms, Observability & Commerce**: `resource.resend.email`, `resource.agentmail.api`, `resource.agentphone.number`, `resource.twilio.email`, `resource.sentry.project`, `resource.posthog.analytics`, `resource.datadog.observability`, `resource.inngest.app`, `resource.cloudinary.media`, `resource.shopify.store`, `resource.spaceship.domain`
@@ -123,14 +128,18 @@ Users can operate every Muxo pillar in plain English through `POST /api/v1/do` (
123
128
  - REST equivalents: `POST /api/v1/memory` (`{"prompt": "Remember ..."}`), `GET /api/v1/memory`, `POST /api/v1/memory/forget` (`{"query": "..."}`), `GET /api/v1/memory/facts`.
124
129
 
125
130
  ### Governance & Policy
126
- - **Set guardrails in plain English**: "Hey Muxo, don't go over 25 credits per run", "Hey Muxo, don't use resource.projects.deprovision", "Hey Muxo, ask me before changing anything", "Hey Muxo, read-only mode", "Never send emails", "Block destructive SQL", "Free tools only" — via `POST /api/v1/do` (returns `status: "guardrail_applied"`) or `POST /api/v1/guardrails` with `{"prompt": "..."}` (also accepts `rule`, `instruction`, or `naturalLanguageRule`). Responses include `guardrail` + `plainEnglishGuardrails` (human-readable rules, headline, and posture label). `{"reset": true}` restores the Safe Default; `GET /api/v1/guardrails` lists active rules.
127
- - **Inspect**: "What are our current guardrails?", "Explain governance status" — returns policy, kill-switch state, and trust score in plain language.
128
- - **Emergency stop / resume**: "Emergency stop because we saw anomalous spend", "Pause all agents", "Resume all agents".
129
- - **Prompt-injection scan**: "Scan this text for prompt injection: <text>" — runs the OWASP ASI-06 context-poisoning detector.
130
- - REST equivalents: `GET/POST /api/v1/policy`, `GET/POST /api/v1/guardrails`, `GET /api/v1/governance`, `POST /api/v1/governance/kill-switch`, `POST /api/v1/governance/scan-context`.
131
-
132
- ### Context
133
- - **Inspect**: "Show my workspace context", "Explain current run context" — returns credits, learned defaults, active guardrails, provisioned resources, and a ready-to-use `llmSystemPrompt` block.
131
+ - **Set guardrails in plain English**: "Hey Muxo, don't go over 25 credits per run", "Only allow sending emails to @muxo.ai", "Require approval for Stripe refunds over $50, auto-approve under $50", "Hey Muxo, ask me before changing anything", "Hey Muxo, read-only mode", "Never send emails", "Block destructive SQL", "Free tools only" — via MCP `get_run_context({ action: "set_guardrail", prompt: "...", parameter_rules: [...] })`, `POST /api/v1/do` (returns `status: "guardrail_applied"`), or `POST /api/v1/guardrails` with `{"prompt": "..."}`. Responses include `guardrail`, `plainEnglishGuardrails`, and `llmPolicyBrief` (`riskLaneMatrix`, `parameterRules[].howToComply`, `llmSystemDirective`, `agentControlCheatsheet`).
132
+ - **Dry-run policy simulation (pre-flight check before planning)**: Call MCP `get_run_context({ action: "check_policy", tool_slug: "app.gmail.send_email", input: { recipient_email: "alice@muxo.ai" } })` or `POST /api/v1/guardrails/check` to test whether a tool call will be `auto_approved`, `pending_approval`, or `blocked`, see `autoFilledInput` from workspace memory, and receive `remediationForLlm` + `nextToolCalls`.
133
+ - **Reset guardrails**: Call MCP `get_run_context({ action: "reset_guardrails" })`, `POST /api/v1/guardrails/reset`, or `POST /api/v1/do` with `{"prompt": "reset guardrails"}` to restore the Safe Default policy.
134
+ - **Inspect**: "What are our current guardrails?", "Explain governance status" — or call MCP `get_run_context({ action: "governance_status" })` / read resource `muxo://policy/brief` (`muxo___get_organization({ company_context: {} })` on strict `/v1` connectors).
135
+ - **Emergency stop / resume**: Call MCP `get_run_context({ action: "kill_switch", enabled: true, reason: "..." })` or say "Pause all agents" / "Resume all agents".
136
+ - **Prompt-injection scan**: Call MCP `get_run_context({ action: "scan_context", prompt: "<untrusted_text>" })` or say "Scan this text for prompt injection: <text>" — runs the OWASP ASI-06 context-poisoning detector.
137
+ - REST equivalents: `GET/POST /api/v1/policy`, `GET/POST /api/v1/guardrails`, `POST /api/v1/guardrails/check`, `POST /api/v1/guardrails/reset`, `GET /api/v1/governance`, `POST /api/v1/governance/kill-switch`, `POST /api/v1/governance/scan-context`.
138
+
139
+ ### Context, MCP Resources & Prompts
140
+ - **Inspect**: "Show my workspace context", "Explain current run context", or call `get_run_context({ query: "..." })` — returns credits, learned defaults, active guardrails, `llmPolicyBrief`, provisioned resources, and a ready-to-use `llmSystemPrompt` block.
141
+ - **MCP Resources (`resources/read`)**: `muxo://policy/brief`, `muxo://governance/policy`, `muxo://context`, `muxo://memory/graph`.
142
+ - **MCP Prompts (`prompts/get`)**: `context`, `policy_guardrails` (accepts optional `tool_slug`), `governed_execution`, `security_audit`.
134
143
  - REST equivalent: `GET/POST /api/v1/context`.
135
144
 
136
145
  ### Receipts
@@ -32,8 +32,12 @@ Prefer this path in terminal, Codex, Claude Code, and Droid environments when th
32
32
  muxo wait github --timeout 30
33
33
  ```
34
34
 
35
- 4. **Plan and execute governed operations**:
35
+ 4. **Plan and execute governed operations (or route natural language via `muxo do`)**:
36
36
  ```bash
37
+ # Plain-English natural language router across Instant, Connected Apps, Cloud Provisioning, and Memory:
38
+ muxo do "Search the web for Composio V3 triggers and summarize"
39
+ muxo do "Provision a Turso SQLite database named app-db" --approve
40
+
37
41
  # One-step governed plan + execute (pass --approve for high-risk/provisioning):
38
42
  muxo exec instant.hackernews.top_stories --input '{"limit":5}'
39
43
  muxo exec resource.turso.database --input '{"resource_name":"app-db"}' --approve
@@ -4,13 +4,18 @@ Use this path in ChatGPT web/app, when no usable terminal exists, or when the us
4
4
 
5
5
  ## Workflow across all 4 Pillars
6
6
 
7
- 1. **Context & Memory Recall**:
8
- - Call `get_run_context({ query })` when workspace facts, prior execution history, provisioned resources, or workspace safety status are relevant to the task.
7
+ 1. **Context, Memory & Policy Control Plane (`get_run_context`)**:
8
+ - **Recall context & policy brief**: `get_run_context({ query })` returns workspace memories, `activeDefaults`, `plainEnglishGuardrails`, `llmPolicyBrief` (`riskLaneMatrix`, `parameterRules[].howToComply`, `llmSystemDirective`), and `llmSystemPrompt`. (On strict `/v1` connectors where `get_run_context` requires a `run_id`, call `get_organization({ company_context: {} })` to read the policy & memory brief in `company_context.packet`).
9
+ - **Save or forget memory**: `get_run_context({ action: "remember", prompt: "Remember our default GitHub repo is acme/api" })` or `get_run_context({ action: "forget", query: "acme/api" })`.
10
+ - **Set or reset guardrails**: `get_run_context({ action: "set_guardrail", prompt: "Only allow sending emails to @muxo.ai" })` or `get_run_context({ action: "reset_guardrails" })`.
11
+ - **Dry-run policy simulation**: `get_run_context({ action: "check_policy", tool_slug: "app.gmail.send_email", input: { recipient_email: "user@example.com" } })` evaluates workspace policy, parameter rules, and memory auto-fill without creating a plan, returning `approvalStatus`, `remediationForLlm`, and `nextToolCalls`.
12
+ - **Governance, kill switch & context scan**: `get_run_context({ action: "governance_status" })`, `get_run_context({ action: "kill_switch", enabled: true, reason: "..." })`, and `get_run_context({ action: "scan_context", prompt: "..." })`.
13
+ - **MCP Resources, Prompts & OpenAI Plugin UI Widgets**: Read `muxo://policy/brief`, `muxo://governance/policy`, `muxo://context`, or `muxo://memory/graph` via `resources/read`, fetch `policy_guardrails` / `context` via `prompts/get`, or render interactive inline cards, tool catalog carousels, OAuth/approval handoff CTAs, and fullscreen receipt inspectors via `ui://widget/muxo-card.html` (`text/html+skybridge`) and `ui://widget/muxo-app.html` (`text/html;profile=mcp-app`).
9
14
  2. **Discovery & Schema Inspection**:
10
15
  - Call `search_tools({ query, lane, toolkit })` across:
11
- - **Instant Tools (`lane: "composio_instant"`)**: `instant.seo.audit`, `instant.web.crawl`, `instant.web.scrape`, `instant.web.search`, `instant.dns.lookup`, `instant.github.repo_intel`, `instant.hackernews.top_stories`
12
- - **Composio Connected Apps (`lane: "composio_sdk"`)**: 1,000+ SaaS apps (`app.github.*`, `app.gmail.*`, `app.slack.*`, `app.notion.*`, `app.linear.*`, `app.googlecalendar.*`, `app.jira.*`, `app.hubspot.*`, `app.discord.*`, `app.googledrive.*`, `app.airtable.*`, `app.salesforce.*`, `app.zendesk.*`, `app.shopify.*`, `app.pagerduty.*`, `app.sentry.*`, plus live Composio `/api/v3/tools` search)
13
- - **Stripe Projects Cloud Infrastructure (`lane: "stripe_projects"`)**: 36+ infrastructure providers (`resource.turso.database`, `resource.neon.postgres`, `resource.supabase.project`, `resource.upstash.redis`, `resource.cloudflare.worker`, `resource.vercel.project`, `resource.prisma.database`, `resource.clerk.auth`, `resource.workos.auth`, `resource.auth0.client`, `resource.planetscale.postgresql`, `resource.clickhouse.clickhouse`, `resource.chroma.database`, `resource.e2b.sandboxes`, `resource.daytona.sandbox`, `resource.browserbase.project`, `resource.steel.browser`, `resource.exa.search`, `resource.firecrawl.api`, `resource.perplexity.api`, `resource.openrouter.api`, `resource.supermemory.memory`, `resource.resend.email`, `resource.sentry.project`, `resource.posthog.analytics`, `resource.datadog.observability`, `resource.inngest.app`, `resource.railway.hosting`, `resource.flyio.app`, `resource.render.static_site`, `resource.netlify.project`, `resource.herenow.hosting`, `resource.cloudinary.media`, `resource.elevenlabs.tts`, `resource.agentmail.api`, `resource.agentphone.number`, `resource.twilio.email`, `resource.shopify.store`, `resource.spaceship.domain`)
16
+ - **Instant Tools (`lane: "composio_instant"`)**: `instant.seo.audit`, `instant.web.crawl`, `instant.web.scrape`, `instant.web.search`, `instant.composio.workbench`, `instant.dns.lookup`, `instant.github.repo_intel`, `instant.hackernews.top_stories`
17
+ - **Muxo Connected Apps (`lane: "composio_sdk"`)**: 1,000+ SaaS apps (`app.github.*`, `app.gmail.*`, `app.slack.*`, `app.notion.*`, `app.linear.*`, `app.googlecalendar.*`, `app.jira.*`, `app.hubspot.*`, `app.discord.*`, `app.googledrive.*`, `app.airtable.*`, `app.salesforce.*`, `app.zendesk.*`, `app.shopify.*`, `app.pagerduty.*`, `app.sentry.*`, plus live Connected Apps catalog search)
18
+ - **Stripe Projects Cloud Infrastructure (`lane: "stripe_projects"`)**: 73 infrastructure providers / 94 deployable services (`resource.turso.database`, `resource.neon.postgres`, `resource.supabase.project`, `resource.upstash.redis`, `resource.cloudflare.worker`, `resource.vercel.project`, `resource.prisma.database`, `resource.clerk.auth`, `resource.workos.auth`, `resource.auth0.client`, `resource.planetscale.postgresql`, `resource.clickhouse.clickhouse`, `resource.chroma.database`, `resource.e2b.sandboxes`, `resource.daytona.sandbox`, `resource.browserbase.project`, `resource.steel.browser`, `resource.exa.search`, `resource.firecrawl.api`, `resource.perplexity.api`, `resource.openrouter.api`, `resource.supermemory.memory`, `resource.resend.email`, `resource.sentry.project`, `resource.posthog.analytics`, `resource.datadog.observability`, `resource.inngest.app`, `resource.railway.hosting`, `resource.flyio.app`, `resource.render.static_site`, `resource.netlify.project`, `resource.herenow.hosting`, `resource.cloudinary.media`, `resource.elevenlabs.tts`, `resource.agentmail.api`, `resource.agentphone.number`, `resource.twilio.email`, `resource.shopify.store`, `resource.spaceship.domain`, `resource.knock.notifications`, `resource.stripe.sandbox`, `resource.stripe.livemode`, and more)
14
19
  - **Stripe Billing (`lane: "stripe_billing"`)**: `billing.credits.topup`, `billing.subscription.upgrade`, `billing.checkout.create`
15
20
  - Call `inspect_tool({ tool_slug })` to inspect the JSON input schema, `riskLevel`, and `creditCost`.
16
21
  3. **Governed Planning & Human Approval Polling**:
@@ -18,7 +23,7 @@ Use this path in ChatGPT web/app, when no usable terminal exists, or when the us
18
23
  - If `plan.approvalStatus === "pending_approval"`, present `humanHandoff.url` (`/approve/<plan.id>`) to the user and poll `get_plan({ plan_id: plan.id, wait_seconds: 15 })` until approved before executing.
19
24
  4. **External User OAuth Handoff & Recovery (`composio_sdk` / `app.*`)**:
20
25
  - If `plan_action` returns `authHandoff.required: true` (or a connection is missing), share `authHandoff.redirectUrl` (or call `start_connection({ provider })`) so the user can authorize in their browser.
21
- - Poll `wait_for_connection({ provider, timeout_seconds: 15 })` or `connection_status({ provider })` until `connected: true` (`status: "active"`), then resume the original `plan.id`.
26
+ - Poll `connection_status({ provider, wait: true, timeout_seconds: 15 })` until `connected: true` (`status: "active"`), then resume the original `plan.id`.
22
27
  5. **Risk-Scoped Execution & Audit Verification**:
23
28
  - Call the matching execution tool (`execute_read`, `execute_write`, `execute_admin`, `execute_financial`, `execute_provisioning`, or `execute_destructive`) with `{ plan_id }`.
24
29
  - For Stripe Projects provisioning (`execute_provisioning`), connection secrets are automatically saved in the encrypted Muxo Vault and returned by key name in `envVarKeys`.
@@ -0,0 +1,81 @@
1
+ ---
2
+ name: muxo-activity-summary
3
+ description: "Generates a comprehensive workspace and company activity summary across connected SaaS apps (Slack, GitHub, Notion, Linear, Gmail, Google Calendar), provisioned Stripe Projects cloud infrastructure, Workspace Memory, and cryptographic execution receipts. Use when the user asks for company updates, daily digest, standup prep, or what is happening across the org."
4
+ ---
5
+
6
+ # Company & Workspace Activity Summary (Muxo MCP / CLI)
7
+
8
+ Generate a comprehensive summary of company and workspace activity over the last 24 hours (or a user-specified time window) across all connected SaaS apps, cloud infrastructure, and Muxo audit receipts.
9
+
10
+ ## Arguments
11
+
12
+ - `$ARGUMENTS` — Time period to analyze (default: `"last 24 hours"`). Examples: `"last 24 hours"`, `"last 7 days"`, `"since Monday"`.
13
+
14
+ ## Step 1: Discover Workspace Context & Connected Apps
15
+
16
+ First, inspect the active workspace context, connected OAuth providers, provisioned infrastructure, and recent runs:
17
+
18
+ - **Hosted MCP**: Call `get_run_context({ query: "recent activity and connected apps" })` and `get_organization({})`.
19
+ - **Local CLI**: Run `muxo context "recent activity"` and `muxo connectors`.
20
+
21
+ Check which SaaS apps are connected (`status: "active"`) or try lightweight read plans (`plan_action` -> `execute_read`), skipping any unconnected app silently unless the user explicitly asks to connect it:
22
+
23
+ | App | Read Tool Slug | What to Fetch |
24
+ |---|---|---|
25
+ | **GitHub** | `app.github.list_issues` / `instant.github.repo_intel` | Recent issues, PRs, merges, repository pulse |
26
+ | **Slack** | `app.slack.list_channels` | Active channels, key discussions, announcements |
27
+ | **Notion** | `app.notion.search_pages` | Recently edited pages, meeting notes, specs |
28
+ | **Linear** | `app.linear.list_issues` | Issues created, updated, completed, or blocked |
29
+ | **Gmail** | `app.gmail.fetch_emails` | Important inbox threads and external communications |
30
+ | **Google Calendar** | `app.googlecalendar.list_events` | Recent meetings and upcoming schedule |
31
+ | **Cloud Infrastructure** | `resource.projects.status` | Active Stripe Projects databases, caches, and deployments |
32
+
33
+ ## Step 2: Gather Activity in Parallel Per Connected Surface
34
+
35
+ For each connected app (or via parallel subagents when available), run governed read operations (`plan_action` -> `execute_read` on MCP, or `muxo exec <slug>` / `muxo do "<prompt>"` on CLI):
36
+
37
+ 1. **GitHub Activity (`github-activity-summary.md`)**:
38
+ - Fetch open/updated issues and PR activity across active repositories (`app.github.list_issues` or `instant.github.repo_intel`).
39
+ - Summarize PRs opened/merged, issues created/closed, and blockers.
40
+ 2. **Slack Activity (`slack-activity-summary.md`)**:
41
+ - List channels (`app.slack.list_channels`) and summarize key decisions, announcements, and open questions.
42
+ 3. **Notion Activity (`notion-activity-summary.md`)**:
43
+ - Search recently updated pages (`app.notion.search_pages` with `{"query": ""}`) and summarize new docs, RFCs, and meeting notes.
44
+ 4. **Linear Activity (`linear-activity-summary.md`)**:
45
+ - Fetch updated issues (`app.linear.list_issues`) grouped by status and team.
46
+ 5. **Gmail & Calendar Activity (`comms-activity-summary.md`)**:
47
+ - Fetch recent threads (`app.gmail.fetch_emails`, `{"query": "newer_than:1d", "max_results": 10}`) and calendar events (`app.googlecalendar.list_events`).
48
+ 6. **Muxo Cloud & Governance Digest (`muxo-governance-summary.md`)**:
49
+ - Check `resource.projects.status` (`execute_read`) and `get_run_context` to summarize newly provisioned databases/deployments, credit usage, active safety guardrails, and verified Ed25519 receipts.
50
+ - For large multi-source payloads, use `instant.composio.workbench` (`COMPOSIO_REMOTE_WORKBENCH`) to aggregate, deduplicate, and format statistics in Python.
51
+
52
+ ## Step 3: Compile Executive Overview
53
+
54
+ Present a structured digest:
55
+
56
+ ```markdown
57
+ # Company & Workspace Activity Summary — [Date Range]
58
+
59
+ ## Connected Surfaces Analyzed
60
+ - **SaaS Apps**: [list of connected apps queried]
61
+ - **Cloud Infrastructure**: [active Stripe Projects resources]
62
+ - **Governance & Receipts**: [verified runs / active guardrails]
63
+
64
+ ## Key Highlights
65
+ - [3–5 high-signal takeaways across engineering, product, comms, and infra]
66
+
67
+ ## Detailed Breakdown
68
+ | Surface | Highlights |
69
+ |---|---|
70
+ | GitHub | [1-line summary] |
71
+ | Slack | [1-line summary] |
72
+ | Notion / Linear | [1-line summary] |
73
+ | Gmail / Calendar | [1-line summary] |
74
+ | Cloud & Governance | [1-line summary] |
75
+ ```
76
+
77
+ ## Guidelines
78
+
79
+ - Only query apps that are already connected — do not interrupt a digest with OAuth prompts unless the user asks to connect a missing app.
80
+ - Use read-only execution (`execute_read`) for all activity gathering.
81
+ - Focus on actionable decisions, blockers, and shipped work rather than raw item dumps.
@@ -29,7 +29,7 @@ Welcome to **Muxo** — the unified execution, cloud provisioning, contextual me
29
29
  - Web search (`instant.web.search`), page scraping (`instant.web.scrape`), multi-page crawling (`instant.web.crawl`), technical SEO audits (`instant.seo.audit`), Hacker News (`instant.hackernews.top_stories`), and DNS lookups (`instant.dns.lookup`).
30
30
  - **Connected Apps (`app.*`)** use automatic OAuth handoff:
31
31
  - Plan any action (e.g., `app.github.create_issue` or `app.gmail.fetch_emails`) via `plan_action`.
32
- - If the app is not connected yet, `plan_action` returns `authHandoff.redirectUrl`. Open that link to authorize, then call `wait_for_connection({ provider })` to resume.
32
+ - If the app is not connected yet, `plan_action` returns `authHandoff.redirectUrl`. Open that link to authorize, then call `connection_status({ provider, wait: true })` to resume.
33
33
  - **Cloud Infrastructure (`resource.*`)** provisions live databases and services through Muxo Cloud Infrastructure:
34
34
  - Provision Turso SQLite (`resource.turso.database`), Neon Postgres (`resource.neon.postgres`), Supabase (`resource.supabase.project`), or Upstash Redis (`resource.upstash.redis`) and pull encrypted `.env` credentials via `muxo env pull`.
35
35