pikiloop 0.4.0

package/dist/catalog/index.js

@@ -0,0 +1,21 @@
+/**
+ * src/catalog — data-only manifests of everything the Extensions page offers.
+ *
+ * This directory is the *single* place you edit to add/remove items from the
+ * Dashboard. Each file is a plain TypeScript array; no logic lives here.
+ *
+ *   mcp-servers.ts  — Extensions → MCP tab
+ *   cli-tools.ts    — Extensions → CLI tab
+ *   skill-repos.ts  — Extensions → Skills tab
+ *
+ * The loading / auth / install logic lives in:
+ *   - src/agent/mcp/{registry,extensions,oauth}.ts   (MCP)
+ *   - src/agent/cli/{registry,detector,auth}.ts      (CLI)
+ *   - src/agent/{skills,skill-installer}.ts          (Skills)
+ *
+ * Those modules own the types and execute the runtime flows; this directory
+ * exists purely so "what to show" stays editable in one spot.
+ */
+export { MCP_SERVERS } from './mcp-servers.js';
+export { CLI_TOOLS } from './cli-tools.js';
+export { SKILL_REPOS } from './skill-repos.js';

package/dist/catalog/local-models.js

@@ -0,0 +1,94 @@
+/**
+ * Local model catalog — curated set of coding-friendly open models that
+ * pikiloop recommends for self-hosted backends (Ollama / mlx-lm).
+ *
+ * Per-backend identifier rules:
+ *   - `ollamaTag`  — entry exists in Ollama's library
+ *   - `mlxModel`   — HuggingFace repo under `mlx-community/` (Apple Silicon)
+ *   Either field is optional; the dashboard filters by backend before display.
+ *
+ * Sizing rules of thumb (Q4 quants on disk):
+ *   weights_gb   ≈ params_b × 0.6
+ *   min_ram_gb   ≈ weights_gb × 1.5 + 4   // KV cache + OS headroom
+ *
+ * `minRamGb` is conservative on purpose.
+ */
+export const LOCAL_MODELS = [
+    // ── Tier A: 16 GB Macs ─────────────────────────────────────────────────────
+    {
+        id: 'qwen2.5-coder-7b',
+        name: 'Qwen2.5-Coder 7B',
+        publisher: 'Alibaba Qwen',
+        paramsB: 7,
+        sizeGb: 5,
+        minRamGb: 16,
+        description: 'Compact coding-tuned model; a strong 16 GB Mac default for agent loops.',
+        descriptionZh: '面向代码的小模型，16GB Mac 上跑 agent 的稳健选择。',
+        ollamaTag: 'qwen2.5-coder:7b',
+        mlxModel: 'mlx-community/Qwen2.5-Coder-7B-Instruct-4bit',
+        homepage: 'https://qwenlm.github.io/blog/qwen2.5-coder/',
+    },
+    {
+        id: 'llama-3.3-8b',
+        name: 'Llama 3.3 8B Instruct',
+        publisher: 'Meta',
+        paramsB: 8,
+        sizeGb: 5,
+        minRamGb: 16,
+        description: 'General-purpose chat; competent tool use, weaker on long-form code edits.',
+        descriptionZh: '通用对话模型，工具调用合格，长代码改写偏弱。',
+        ollamaTag: 'llama3.3:8b',
+        homepage: 'https://www.llama.com/',
+    },
+    {
+        id: 'gemma3-4b',
+        name: 'Gemma 3 4B',
+        publisher: 'Google DeepMind',
+        paramsB: 4,
+        sizeGb: 3,
+        minRamGb: 8,
+        description: 'Smallest entry — runs on 8 GB Macs but tool-use is limited.',
+        descriptionZh: '清单里最小的模型，8GB Mac 可跑，工具调用能力有限。',
+        ollamaTag: 'gemma3:4b',
+        homepage: 'https://ai.google.dev/gemma',
+    },
+    // ── Tier B: 24-32 GB sweet spot ────────────────────────────────────────────
+    {
+        id: 'deepseek-coder-v2-lite',
+        name: 'DeepSeek-Coder V2 Lite',
+        publisher: 'DeepSeek',
+        paramsB: 16,
+        sizeGb: 10,
+        minRamGb: 24,
+        description: '16B MoE (~2.4B active) — fast inference + strong code reasoning at mid RAM.',
+        descriptionZh: '16B MoE（≈2.4B 激活），中等内存下推理快、代码理解强。',
+        ollamaTag: 'deepseek-coder-v2:16b',
+        homepage: 'https://github.com/deepseek-ai/DeepSeek-Coder-V2',
+    },
+    {
+        id: 'phi-4',
+        name: 'Phi-4 14B',
+        publisher: 'Microsoft',
+        paramsB: 14,
+        sizeGb: 9,
+        minRamGb: 24,
+        description: 'Reasoning-tuned 14B; punches above its weight on code and tool tasks.',
+        descriptionZh: '14B 推理向模型，代码与工具任务上超出参数量预期。',
+        ollamaTag: 'phi4:14b',
+        homepage: 'https://huggingface.co/microsoft/phi-4',
+    },
+    // ── Tier S: 36+ GB unified memory ──────────────────────────────────────────
+    {
+        id: 'qwen2.5-coder-32b',
+        name: 'Qwen2.5-Coder 32B',
+        publisher: 'Alibaba Qwen',
+        paramsB: 32,
+        sizeGb: 20,
+        minRamGb: 36,
+        description: 'Flagship open coding model — needs an Apple Silicon Pro/Max with 36 GB+ unified memory.',
+        descriptionZh: '开源代码旗舰，建议 36GB+ 统一内存的 M-Pro/Max。',
+        ollamaTag: 'qwen2.5-coder:32b',
+        mlxModel: 'mlx-community/Qwen2.5-Coder-32B-Instruct-4bit',
+        homepage: 'https://qwenlm.github.io/blog/qwen2.5-coder/',
+    },
+];

package/dist/catalog/mcp-servers.js

@@ -0,0 +1,315 @@
+/**
+ * MCP server catalog — single source of truth for what the Dashboard shows
+ * under Extensions → MCP.
+ *
+ * ─── How this plugs into the rest of the stack ───────────────────────────────
+ *
+ *   Dashboard → GET /api/extensions/mcp/catalog
+ *     → dashboard/routes/extensions.ts
+ *       → agent/mcp/extensions.ts      (merge + state computation)
+ *         → agent/mcp/registry.ts      (types + re-exports this array)
+ *           ← src/catalog/mcp-servers.ts ← YOU ARE HERE
+ *
+ * The registry module owns types and helper functions (install / OAuth / health).
+ * This file owns only the *data*. To add a new MCP server, append an entry here
+ * and the whole pipeline picks it up. To hide an entry, remove/comment it out —
+ * users who already installed it keep their setup; we only stop recommending.
+ *
+ * ─── recommendedScope ────────────────────────────────────────────────────────
+ *
+ *   'global'    — account-level SaaS (GitHub, Atlassian, …). Shown in the
+ *                 Extensions tab; hidden from the Workspace modal.
+ *   'workspace' — tools that depend on project context (Filesystem, SQLite,
+ *                 Postgres). Shown in the Workspace modal; hidden globally.
+ *   'both'      — useful in either place (rarely needed; avoid unless obvious).
+ *
+ * Generic protocol-demo servers (time / fetch / memory from @modelcontextprotocol)
+ * were intentionally removed — they don't carry a product identity and added
+ * clutter rather than value.
+ */
+export const MCP_SERVERS = [
+    // ── Built-in (pikiloop-managed) ────────────────────────────────────────────
+    {
+        id: 'pikiloop-browser',
+        name: 'Browser Automation',
+        description: 'Optimized Playwright MCP — managed Chrome with shared profile, CDP attach, and supervisor lifecycle.',
+        descriptionZh: '基于 Playwright MCP 的定制版浏览器自动化：受管 Chrome、共享 profile、CDP 附着、进程级 supervisor。',
+        category: 'utility',
+        recommendedScope: 'global',
+        transport: { type: 'stdio', command: '@playwright/mcp', args: ['(managed by pikiloop)'] },
+        auth: { type: 'none' },
+        iconSlug: 'playwright',
+        homepage: 'https://github.com/microsoft/playwright-mcp',
+        isBuiltin: true,
+    },
+    {
+        id: 'peekaboo',
+        name: 'Peekaboo',
+        description: 'Native macOS GUI control via Accessibility API + ScreenCaptureKit (click, type, scroll, windows, menus, Dock). Requires Screen Recording + Accessibility permissions. macOS only.',
+        descriptionZh: '通过 macOS Accessibility 与 ScreenCaptureKit 实现原生 GUI 控制（点击、输入、滚动、窗口、菜单、Dock）。需要"屏幕录制"与"辅助功能"两项系统权限，仅支持 macOS。',
+        category: 'utility',
+        recommendedScope: 'global',
+        transport: { type: 'stdio', command: 'npx', args: ['-y', '-p', '@steipete/peekaboo', 'peekaboo-mcp'] },
+        auth: { type: 'none' },
+        iconSlug: 'peekaboo',
+        iconUrl: 'https://peekaboo.sh/favicon.svg',
+        homepage: 'https://peekaboo.sh/',
+        isBuiltin: true,
+    },
+    // ── Local filesystems / databases (workspace scope) ────────────────────────
+    {
+        id: 'filesystem',
+        name: 'Filesystem',
+        description: 'Read, write, and search files on the local machine',
+        descriptionZh: '读写和搜索本机文件',
+        category: 'utility',
+        recommendedScope: 'workspace',
+        transport: { type: 'stdio', command: 'npx', args: ['-y', '@modelcontextprotocol/server-filesystem', '${WORKDIR}'] },
+        auth: { type: 'none' },
+        iconSlug: 'filesystem',
+    },
+    {
+        id: 'sqlite',
+        name: 'SQLite',
+        description: 'Query and manage local SQLite databases',
+        descriptionZh: '查询和管理本地 SQLite 数据库',
+        category: 'data',
+        recommendedScope: 'workspace',
+        transport: { type: 'stdio', command: 'uvx', args: ['mcp-server-sqlite', '--db-path', '${WORKDIR}/data.db'] },
+        auth: { type: 'none' },
+        iconSlug: 'sqlite',
+    },
+    {
+        id: 'postgres',
+        name: 'PostgreSQL',
+        description: 'Query and manage PostgreSQL databases',
+        descriptionZh: '查询和管理 PostgreSQL 数据库',
+        category: 'data',
+        recommendedScope: 'workspace',
+        transport: { type: 'stdio', command: 'npx', args: ['-y', '@modelcontextprotocol/server-postgres', '${POSTGRES_CONNECTION_STRING}'] },
+        auth: {
+            type: 'credentials',
+            fields: [{
+                    key: 'POSTGRES_CONNECTION_STRING',
+                    label: 'Connection string',
+                    labelZh: '连接串',
+                    required: true,
+                    placeholder: 'postgresql://user:pass@host:5432/db',
+                }],
+        },
+        iconSlug: 'postgres',
+    },
+    // ── Global-scope SaaS with MCP-OAuth ───────────────────────────────────────
+    {
+        id: 'github',
+        name: 'GitHub',
+        description: 'Repositories, pull requests, issues, code search',
+        descriptionZh: '仓库、PR、Issue、代码搜索',
+        category: 'dev',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://api.githubcopilot.com/mcp/' },
+        auth: { type: 'mcp-oauth', scopes: ['repo', 'read:org'] },
+        iconSlug: 'github',
+        homepage: 'https://github.com/github/github-mcp-server',
+    },
+    {
+        id: 'atlassian',
+        name: 'Atlassian',
+        description: 'Jira issues, Confluence pages, sprint planning',
+        descriptionZh: 'Jira 工单、Confluence 文档、Sprint 管理',
+        category: 'productivity',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://mcp.atlassian.com/v1/sse' },
+        auth: { type: 'mcp-oauth' },
+        iconSlug: 'atlassian',
+        homepage: 'https://www.atlassian.com/platform/remote-mcp-server',
+    },
+    {
+        id: 'notion',
+        name: 'Notion',
+        description: 'Read, write, and search Notion pages and databases',
+        descriptionZh: '读写和搜索 Notion 页面与数据库',
+        category: 'productivity',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://mcp.notion.com/mcp' },
+        auth: { type: 'mcp-oauth' },
+        iconSlug: 'notion',
+        homepage: 'https://developers.notion.com/docs/mcp',
+    },
+    {
+        id: 'linear',
+        name: 'Linear',
+        description: 'Issues, projects, cycles, and team workflows',
+        descriptionZh: 'Issue、项目、周期和团队协作',
+        category: 'productivity',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://mcp.linear.app/sse' },
+        auth: { type: 'mcp-oauth' },
+        iconSlug: 'linear',
+        homepage: 'https://linear.app/docs/mcp',
+    },
+    {
+        id: 'sentry',
+        name: 'Sentry',
+        description: 'Error tracking — search issues, view stack traces',
+        descriptionZh: '错误追踪 — 查询 Issue、查看堆栈',
+        category: 'dev',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://mcp.sentry.dev/mcp' },
+        auth: { type: 'mcp-oauth' },
+        iconSlug: 'sentry',
+        homepage: 'https://docs.sentry.io/product/sentry-mcp/',
+    },
+    // ── Cloudflare trio (control plane / observability / docs) ─────────────────
+    {
+        id: 'cloudflare-bindings',
+        name: 'Cloudflare',
+        description: 'Manage Workers, Pages, R2, D1, KV — the full control plane',
+        descriptionZh: '管理 Workers / Pages / R2 / D1 / KV — 完整控制面',
+        category: 'dev',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://bindings.mcp.cloudflare.com/sse' },
+        auth: { type: 'mcp-oauth' },
+        iconSlug: 'cloudflare',
+        homepage: 'https://developers.cloudflare.com/agents/model-context-protocol/',
+    },
+    {
+        id: 'cloudflare-observability',
+        name: 'Cloudflare Observability',
+        description: 'Workers logs, analytics, and traces',
+        descriptionZh: 'Workers 日志、分析与追踪',
+        category: 'dev',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://observability.mcp.cloudflare.com/sse' },
+        auth: { type: 'mcp-oauth' },
+        iconSlug: 'cloudflare',
+        homepage: 'https://developers.cloudflare.com/agents/model-context-protocol/',
+    },
+    {
+        id: 'cloudflare-docs',
+        name: 'Cloudflare Docs',
+        description: 'Search and query Cloudflare documentation',
+        descriptionZh: '搜索和查询 Cloudflare 文档',
+        category: 'dev',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://docs.mcp.cloudflare.com/sse' },
+        auth: { type: 'mcp-oauth' },
+        iconSlug: 'cloudflare',
+        homepage: 'https://developers.cloudflare.com/agents/model-context-protocol/',
+    },
+    // ── More SaaS integrations ─────────────────────────────────────────────────
+    {
+        id: 'gamma',
+        name: 'Gamma',
+        description: 'Generate AI-powered presentations and documents',
+        descriptionZh: '生成 AI 驱动的演示文稿和文档',
+        category: 'productivity',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://mcp.gamma.app/mcp' },
+        auth: { type: 'mcp-oauth' },
+        iconSlug: 'gamma',
+        homepage: 'https://gamma.app/docs/mcp',
+    },
+    {
+        id: 'hugging-face',
+        name: 'Hugging Face',
+        description: 'Models, datasets, spaces, and inference',
+        descriptionZh: '模型、数据集、Spaces 和推理',
+        category: 'dev',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://huggingface.co/mcp' },
+        auth: { type: 'mcp-oauth' },
+        iconSlug: 'huggingface',
+        homepage: 'https://huggingface.co/docs/hub/mcp',
+    },
+    {
+        id: 'slack',
+        name: 'Slack',
+        description: 'Read channels, summarize threads, send messages',
+        descriptionZh: '读取频道、总结对话、发送消息',
+        category: 'communication',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://slack.com/api/mcp' },
+        auth: { type: 'mcp-oauth' },
+        iconSlug: 'slack',
+        homepage: 'https://api.slack.com/apis/mcp',
+    },
+    {
+        id: 'lark',
+        name: '飞书 / Lark',
+        description: 'Feishu docs, messages, tasks, bitable',
+        descriptionZh: '飞书文档、消息、任务、多维表格',
+        category: 'communication',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://open.feishu.cn/mcp' },
+        auth: { type: 'mcp-oauth' },
+        iconSlug: 'lark',
+        homepage: 'https://open.feishu.cn/document/mcp',
+    },
+    // ── Remote + API key ───────────────────────────────────────────────────────
+    {
+        id: 'stripe',
+        name: 'Stripe',
+        description: 'Payments, customers, subscriptions, invoices',
+        descriptionZh: '支付、客户、订阅、账单',
+        category: 'data',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://mcp.stripe.com/v1/mcp' },
+        auth: {
+            type: 'credentials',
+            fields: [{
+                    key: 'STRIPE_API_KEY',
+                    label: 'Secret key',
+                    labelZh: 'Secret key',
+                    secret: true,
+                    required: true,
+                    placeholder: 'sk_live_... or sk_test_...',
+                    helpUrl: 'https://dashboard.stripe.com/apikeys',
+                }],
+        },
+        iconSlug: 'stripe',
+        homepage: 'https://docs.stripe.com/mcp',
+    },
+    {
+        id: 'brave-search',
+        name: 'Brave Search',
+        description: 'Web and local search via Brave Search API',
+        descriptionZh: '通过 Brave Search API 进行网页搜索',
+        category: 'search',
+        recommendedScope: 'global',
+        transport: { type: 'stdio', command: 'npx', args: ['-y', '@modelcontextprotocol/server-brave-search'] },
+        auth: {
+            type: 'credentials',
+            fields: [{
+                    key: 'BRAVE_API_KEY',
+                    label: 'API key',
+                    labelZh: 'API 密钥',
+                    secret: true,
+                    required: true,
+                    helpUrl: 'https://api.search.brave.com/app/keys',
+                }],
+        },
+        iconSlug: 'brave',
+    },
+    {
+        id: 'perplexity',
+        name: 'Perplexity',
+        description: 'Answer engine with real-time web search',
+        descriptionZh: '带实时网页检索的问答引擎',
+        category: 'search',
+        recommendedScope: 'global',
+        transport: { type: 'http', url: 'https://api.perplexity.ai/mcp' },
+        auth: {
+            type: 'credentials',
+            fields: [{
+                    key: 'PERPLEXITY_API_KEY',
+                    label: 'API key',
+                    labelZh: 'API 密钥',
+                    secret: true,
+                    required: true,
+                    helpUrl: 'https://www.perplexity.ai/settings/api',
+                }],
+        },
+        iconSlug: 'perplexity',
+    },
+];

package/dist/catalog/skill-repos.js

@@ -0,0 +1,173 @@
+/**
+ * Skill repository catalog — single source of truth for what the Dashboard
+ * shows under Extensions → Skills.
+ *
+ * ─── How this plugs into the rest of the stack ───────────────────────────────
+ *
+ *   Dashboard → GET /api/extensions/skills/catalog
+ *     → dashboard/routes/extensions.ts
+ *       → agent/mcp/registry.ts              (types + re-exports this array)
+ *       → agent/skills.ts                    (locally-installed discovery)
+ *       → agent/skill-installer.ts           (`npx skills add …` runner)
+ *         ← src/catalog/skill-repos.ts       ← YOU ARE HERE
+ *
+ * ─── Curation policy ─────────────────────────────────────────────────────────
+ *
+ * Every entry below is a real, public GitHub repo. Authority signal is GitHub
+ * stars — the dashboard fetches `stars` / `pushedAt` at load time and sorts the
+ * cards by star count, so "more popular = appears higher". Don't add fictional
+ * placeholder entries; if a repo isn't real and starred, users hit a 404 the
+ * moment they click Install.
+ *
+ * ─── How to add a skill pack ─────────────────────────────────────────────────
+ *
+ *   Append a `RecommendedSkillRepo` entry with `source` set to an `owner/repo`
+ *   GitHub slug (or full URL). The install flow runs `npx skills add <source>`
+ *   and drops the skill into `~/.pikiloop/skills/` for global installs, or
+ *   `<workdir>/.pikiloop/skills/` for project installs.
+ */
+export const SKILL_REPOS = [
+    // ── Official / first-party ────────────────────────────────────────────────
+    {
+        id: 'anthropics-skills',
+        name: 'Anthropic Skills',
+        description: 'Official skill collection from Anthropic',
+        descriptionZh: 'Anthropic 官方技能集',
+        source: 'anthropics/skills',
+        category: 'general',
+        recommendedScope: 'global',
+        homepage: 'https://github.com/anthropics/skills',
+    },
+    {
+        id: 'vercel-agent-skills',
+        name: 'Vercel Agent Skills',
+        description: 'Next.js, deployment, and TypeScript workflows',
+        descriptionZh: 'Next.js、部署、TypeScript 工作流',
+        source: 'vercel-labs/agent-skills',
+        category: 'dev',
+        recommendedScope: 'both',
+        homepage: 'https://github.com/vercel-labs/agent-skills',
+    },
+    // ── High-signal community collections (awesome-lists / megapacks) ─────────
+    {
+        id: 'obra-superpowers',
+        name: 'Obra Superpowers',
+        description: 'Opinionated productivity skills — focus, writing, research',
+        descriptionZh: '精选生产力技能 — 专注、写作、调研',
+        source: 'obra/superpowers',
+        category: 'productivity',
+        recommendedScope: 'global',
+        homepage: 'https://github.com/obra/superpowers',
+    },
+    {
+        id: 'antigravity-awesome-skills',
+        name: 'Antigravity Awesome Skills',
+        description: 'Installable library of 1,400+ agentic skills',
+        descriptionZh: '可安装的 1,400+ 智能体技能合集',
+        source: 'sickn33/antigravity-awesome-skills',
+        category: 'general',
+        recommendedScope: 'global',
+        homepage: 'https://github.com/sickn33/antigravity-awesome-skills',
+    },
+    {
+        id: 'wshobson-agents',
+        name: 'wshobson Agents',
+        description: 'Multi-agent orchestration and automation for Claude Code',
+        descriptionZh: 'Claude Code 的多智能体编排与自动化',
+        source: 'wshobson/agents',
+        category: 'dev',
+        recommendedScope: 'global',
+        homepage: 'https://github.com/wshobson/agents',
+    },
+    {
+        id: 'voltagent-awesome',
+        name: 'Awesome Agent Skills',
+        description: 'Curated 1,000+ agent skills from official teams and community',
+        descriptionZh: '官方与社区的 1000+ 智能体技能精选合集',
+        source: 'VoltAgent/awesome-agent-skills',
+        category: 'general',
+        recommendedScope: 'global',
+        homepage: 'https://github.com/VoltAgent/awesome-agent-skills',
+    },
+    {
+        id: 'alirezarezvani-claude-skills',
+        name: 'Claude Skills 232+',
+        description: '232+ Claude Code skills & plugins for Claude/Codex/Gemini',
+        descriptionZh: '232+ Claude Code 技能与插件，覆盖 Claude/Codex/Gemini',
+        source: 'alirezarezvani/claude-skills',
+        category: 'general',
+        recommendedScope: 'global',
+        homepage: 'https://github.com/alirezarezvani/claude-skills',
+    },
+    // ── Domain-specific high-quality skills ───────────────────────────────────
+    {
+        id: 'planning-with-files',
+        name: 'Planning with Files',
+        description: 'Manus-style persistent markdown planning workflow',
+        descriptionZh: 'Manus 风格的 Markdown 持久化规划工作流',
+        source: 'OthmanAdi/planning-with-files',
+        category: 'productivity',
+        recommendedScope: 'both',
+        homepage: 'https://github.com/OthmanAdi/planning-with-files',
+    },
+    {
+        id: 'scientific-agent-skills',
+        name: 'Scientific Agent Skills',
+        description: 'Research, science, engineering, and analysis skills',
+        descriptionZh: '科研、工程、分析方向的智能体技能集',
+        source: 'K-Dense-AI/scientific-agent-skills',
+        category: 'productivity',
+        recommendedScope: 'global',
+        homepage: 'https://github.com/K-Dense-AI/scientific-agent-skills',
+    },
+    {
+        id: 'frontend-slides',
+        name: 'Frontend Slides',
+        description: 'Generate beautiful web-based slides with frontend skills',
+        descriptionZh: '用前端技能生成精美的网页幻灯片',
+        source: 'zarazhangrui/frontend-slides',
+        category: 'productivity',
+        recommendedScope: 'both',
+        homepage: 'https://github.com/zarazhangrui/frontend-slides',
+    },
+    {
+        id: 'design-extract',
+        name: 'Design Extract',
+        description: 'Extract a website\'s complete design system in one command',
+        descriptionZh: '一条命令提取任意网站的完整设计系统',
+        source: 'Manavarya09/design-extract',
+        category: 'dev',
+        recommendedScope: 'both',
+        homepage: 'https://github.com/Manavarya09/design-extract',
+    },
+    {
+        id: 'opencli',
+        name: 'OpenCLI',
+        description: 'Universal CLI hub turning 100+ websites and local binaries into agent-callable commands (requires global `opencli` CLI + Chrome bridge extension)',
+        descriptionZh: '通用 CLI Hub，把 100+ 网站和本地二进制变成可调用命令（依赖全局 opencli CLI 与 Chrome 桥接扩展）',
+        source: 'jackwener/opencli',
+        category: 'dev',
+        recommendedScope: 'global',
+        homepage: 'https://github.com/jackwener/opencli',
+    },
+    {
+        id: 'rocketsim-skills',
+        name: 'RocketSim',
+        description: '30+ tools for Xcode iOS Simulator — testing, debugging',
+        descriptionZh: 'Xcode iOS 模拟器的 30+ 工具：测试、调试、网络',
+        source: 'AvdLee/RocketSimApp',
+        category: 'dev',
+        recommendedScope: 'both',
+        homepage: 'https://github.com/AvdLee/RocketSimApp',
+    },
+    {
+        id: 'nopua',
+        name: 'Nopua',
+        description: 'A skill that unlocks AI potential through respect and care',
+        descriptionZh: '用爱解放 AI 潜能的技能 — 尊重、关怀',
+        source: 'wuji-labs/nopua',
+        category: 'productivity',
+        recommendedScope: 'global',
+        homepage: 'https://github.com/wuji-labs/nopua',
+    },
+];

package/dist/channels/base.js

@@ -0,0 +1,55 @@
+/**
+ * Channel base — minimal abstract for all IM platforms.
+ *
+ * Only defines: lifecycle + outgoing primitives.
+ * Hooks (onCommand, onMessage, onCallback, ...) are platform-specific
+ * and belong in each subclass — different IMs expose different interaction models.
+ */
+export const DEFAULT_CHANNEL_CAPABILITIES = Object.freeze({
+    editMessages: false,
+    typingIndicators: false,
+    commandMenu: false,
+    messageReactions: false,
+    sendImage: false,
+});
+export class Channel {
+    bot = null;
+    capabilities = DEFAULT_CHANNEL_CAPABILITIES;
+    /**
+     * Send an image given in-memory bytes. Default implementation throws — only
+     * channels whose `capabilities.sendImage` is true must override. The bot
+     * uses `supportsChannelCapability(ch, 'sendImage')` to gate dispatch.
+     *
+     * `mime` is the explicit MIME type (e.g. `image/png`) so subclasses can pick
+     * the right native upload primitive (Telegram sendPhoto vs sendDocument;
+     * Feishu uploadImage `image_type=message`; WeChat image message vs file).
+     */
+    async sendImage(_chatId, _bytes, _opts) {
+        throw new Error(`${this.constructor.name} does not implement sendImage`);
+    }
+    async setMenu(_commands) { }
+    async clearMenu() { }
+}
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+export function supportsChannelCapability(channel, capability) {
+    return channel?.capabilities?.[capability] ?? false;
+}
+export function splitText(text, max) {
+    if (text.length <= max)
+        return [text];
+    const chunks = [];
+    let rest = text;
+    while (rest.length > max) {
+        let cut = rest.lastIndexOf('\n', max);
+        if (cut < max * 0.3)
+            cut = max;
+        chunks.push(rest.slice(0, cut));
+        rest = rest.slice(cut);
+    }
+    if (rest)
+        chunks.push(rest);
+    return chunks;
+}
+export function sleep(ms) { return new Promise(r => setTimeout(r, ms)); }