@muxoai/sdk 1.2.3 → 1.4.2

package/plugins/muxo/skills/muxo-activity-summary/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: muxo-activity-summary
+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."
+---
+
+# Company & Workspace Activity Summary (Muxo MCP / CLI)
+
+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.
+
+## Arguments
+
+- `$ARGUMENTS` — Time period to analyze (default: `"last 24 hours"`). Examples: `"last 24 hours"`, `"last 7 days"`, `"since Monday"`.
+
+## Step 1: Discover Workspace Context & Connected Apps
+
+First, inspect the active workspace context, connected OAuth providers, provisioned infrastructure, and recent runs:
+
+- **Hosted MCP**: Call `get_run_context({ query: "recent activity and connected apps" })` and `get_organization({})`.
+- **Local CLI**: Run `muxo context "recent activity"` and `muxo connectors`.
+
+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:
+
+| App | Read Tool Slug | What to Fetch |
+|---|---|---|
+| **GitHub** | `app.github.list_issues` / `instant.github.repo_intel` | Recent issues, PRs, merges, repository pulse |
+| **Slack** | `app.slack.list_channels` | Active channels, key discussions, announcements |
+| **Notion** | `app.notion.search_pages` | Recently edited pages, meeting notes, specs |
+| **Linear** | `app.linear.list_issues` | Issues created, updated, completed, or blocked |
+| **Gmail** | `app.gmail.fetch_emails` | Important inbox threads and external communications |
+| **Google Calendar** | `app.googlecalendar.list_events` | Recent meetings and upcoming schedule |
+| **Cloud Infrastructure** | `resource.projects.status` | Active Stripe Projects databases, caches, and deployments |
+
+## Step 2: Gather Activity in Parallel Per Connected Surface
+
+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):
+
+1. **GitHub Activity (`github-activity-summary.md`)**:
+   - Fetch open/updated issues and PR activity across active repositories (`app.github.list_issues` or `instant.github.repo_intel`).
+   - Summarize PRs opened/merged, issues created/closed, and blockers.
+2. **Slack Activity (`slack-activity-summary.md`)**:
+   - List channels (`app.slack.list_channels`) and summarize key decisions, announcements, and open questions.
+3. **Notion Activity (`notion-activity-summary.md`)**:
+   - Search recently updated pages (`app.notion.search_pages` with `{"query": ""}`) and summarize new docs, RFCs, and meeting notes.
+4. **Linear Activity (`linear-activity-summary.md`)**:
+   - Fetch updated issues (`app.linear.list_issues`) grouped by status and team.
+5. **Gmail & Calendar Activity (`comms-activity-summary.md`)**:
+   - Fetch recent threads (`app.gmail.fetch_emails`, `{"query": "newer_than:1d", "max_results": 10}`) and calendar events (`app.googlecalendar.list_events`).
+6. **Muxo Cloud & Governance Digest (`muxo-governance-summary.md`)**:
+   - 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.
+   - For large multi-source payloads, use `instant.composio.workbench` (`COMPOSIO_REMOTE_WORKBENCH`) to aggregate, deduplicate, and format statistics in Python.
+
+## Step 3: Compile Executive Overview
+
+Present a structured digest:
+
+```markdown
+# Company & Workspace Activity Summary — [Date Range]
+
+## Connected Surfaces Analyzed
+- **SaaS Apps**: [list of connected apps queried]
+- **Cloud Infrastructure**: [active Stripe Projects resources]
+- **Governance & Receipts**: [verified runs / active guardrails]
+
+## Key Highlights
+- [3–5 high-signal takeaways across engineering, product, comms, and infra]
+
+## Detailed Breakdown
+| Surface | Highlights |
+|---|---|
+| GitHub | [1-line summary] |
+| Slack | [1-line summary] |
+| Notion / Linear | [1-line summary] |
+| Gmail / Calendar | [1-line summary] |
+| Cloud & Governance | [1-line summary] |
+```
+
+## Guidelines
+
+- Only query apps that are already connected — do not interrupt a digest with OAuth prompts unless the user asks to connect a missing app.
+- Use read-only execution (`execute_read`) for all activity gathering.
+- Focus on actionable decisions, blockers, and shipped work rather than raw item dumps.

package/plugins/muxo/skills/setup/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: setup
+description: Guided onboarding skill for setting up the Muxo plugin in OpenAI ChatGPT and Codex. Helps users verify workspace authorization, connect external SaaS apps via OAuth handoff, provision cloud infrastructure, or install the local Muxo CLI.
+---
+
+# Muxo Onboarding & Setup
+
+Welcome to **Muxo** — the unified execution, cloud provisioning, contextual memory, and governance platform for OpenAI ChatGPT and Codex.
+
+## Step 1: Verify your Muxo connection
+
+1. If you are in **ChatGPT** or **Codex** with the hosted Muxo MCP server (`https://api.muxo.ai/mcp`) enabled:
+   - Call `get_profile` and `get_organization` to confirm your workspace ID, credit balance (`fundingMode: "muxo_funded"`), and active governance policy.
+2. If you are in a terminal environment and prefer the local CLI (requires **Node.js 22+**):
+   ```bash
+   npx -y @muxoai/cli@latest login --signup --name "my-agent"
+   muxo whoami
+   ```
+   This CLI-first signup calls `POST https://api.muxo.ai/api/v1/agents/signup` to provision a hosted workspace, 250 starter credits, and `mk_live_*` API key in `~/.muxo/config.json`.
+3. Harness-specific setup:
+   - **Claude Code**: `claude plugin marketplace add https://api.muxo.ai/.claude-plugin/marketplace.json && claude plugin install muxo@muxo`
+   - **OpenAI Codex**: Add a Git repository or local marketplace directory containing `.agents/plugins/marketplace.json`, or configure `[mcp_servers.muxo]` (`url = "https://api.muxo.ai/mcp"`) in `~/.codex/config.toml`.
+   - **Claude Desktop**: Use **Settings → Connectors → Add custom connector** (`https://api.muxo.ai/mcp`) for hosted MCP, or configure `npx -y @muxoai/cli@latest mcp` in `claude_desktop_config.json` for the local stdio server.
+   - **ChatGPT**: Open **Plugins → + → Add custom MCP server** and enter `https://api.muxo.ai/mcp` (OAuth registration supports CIMD or DCR).
+
+## Step 2: Connect your first SaaS app or run an Instant tool
+
+- **Zero-OAuth Instant Tools (`instant.*`)** work immediately with no setup:
+  - 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`).
+- **Connected Apps (`app.*`)** use automatic OAuth handoff:
+  - Plan any action (e.g., `app.github.create_issue` or `app.gmail.fetch_emails`) via `plan_action`.
+  - 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.
+- **Cloud Infrastructure (`resource.*`)** provisions live databases and services through Muxo Cloud Infrastructure:
+  - 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`.
+
+## Step 3: Set guardrails, teach memory, and handle approvals
+
+Once connected, you can govern and personalize the workspace in plain English:
+
+- **Guardrails**: "Hey Muxo, don't go over 25 credits per run", "Hey Muxo, read-only mode", "Hey Muxo, ask me before changing anything" (`POST /api/v1/do` returns `status: "guardrail_applied"`; `POST /api/v1/guardrails` with `{"prompt": "..."}` or `{"reset": true}` also works). Responses include human-readable `plainEnglishGuardrails`.
+- **Memory**: "Hey Muxo, remember our default GitHub repo is acme/api and default region is us-east-1" (`status: "memory_saved"`). `plan_action` recalls memory before governance checks and auto-fills defaults (`memoryContext.autoFilledInput`). Ask "What do you remember?" or say "Hey Muxo, forget ..." anytime.
+- **Human handoffs**: Every `plan_action` returns `llmGuidance` with next steps. When a person must act — OAuth connect (`humanHandoff` kind `"oauth"`) or plan approval (`kind: "approval"`, one-click `/approve/<plan_id>` page) — show `humanHandoff.url` to the user and wait for their confirmation before continuing.

package/plugins/muxo/skills/setup/agents/openai.yaml

@@ -0,0 +1,12 @@
+interface:
+  display_name: "Muxo Setup"
+  short_description: "Guided onboarding and connection verification for Muxo in ChatGPT and Codex"
+  default_prompt: "Check my Muxo profile and organization status."
+
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "muxo"
+      description: "Muxo Governed Execution, Instant Web/SEO Tools, Connected Apps, and Cloud Infrastructure MCP Server"
+      transport: "streamable_http"
+      url: "https://api.muxo.ai/mcp"