opencode-catpaw-auth 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zu1k
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,196 @@
+# @zu1k/opencode-catpaw-auth
+
+[![npm version](https://img.shields.io/npm/v/@zu1k/opencode-catpaw-auth.svg)](https://www.npmjs.com/package/@zu1k/opencode-catpaw-auth)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+CatPaw AI provider plugin for [OpenCode](https://opencode.ai/) - Auto-auth from mcopilot-cli config
+
+## Features
+
+- **Zero-config auth**: Automatically loads API key from `~/.config/mcopilot-cli/.config.yaml`
+- **Multi-model support**: LongCat-Flash-Chat, kimi-k2.5, glm-5, MiniMax-M2.5, claude-sonnet-4.5
+- **Auto header injection**: Automatically injects `x-api-key` and `x-working-dir` headers
+- **OpenAI compatible**: Uses `@ai-sdk/openai-compatible` adapter
+
+## Installation
+
+### Method 1: npm (Recommended)
+
+Add the plugin to your OpenCode configuration:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@zu1k/opencode-catpaw-auth"]
+}
+```
+
+### Method 2: Local Development
+
+```bash
+git clone https://github.com/zu1k/opencode-catpaw-auth.git
+cd opencode-catpaw-auth
+bun install
+```
+
+Then use `file://` protocol:
+
+```json
+{
+  "plugin": ["file:///absolute/path/to/opencode-catpaw-auth"]
+}
+```
+
+## Configuration
+
+### 1. Ensure mcopilot-cli config exists
+
+The plugin automatically reads the `AUTHORIZATION` field from `~/.config/mcopilot-cli/.config.yaml`:
+
+```yaml
+# ~/.config/mcopilot-cli/.config.yaml
+AUTHORIZATION: "your-api-key-here"
+# other configurations...
+```
+
+### 2. Connect Provider
+
+Start OpenCode:
+
+```bash
+opencode
+```
+
+Run the connect command:
+
+```
+/connect
+```
+
+Select **CatPaw AI** provider, then choose **"Auto-config from mcopilot-cli"** auth method.
+
+### 3. Select Model
+
+```
+/models
+```
+
+Choose from CatPaw AI models:
+- **LongCat Flash Chat** - Fast response
+- **Kimi K2.5** - Long context support (256K)
+- **GLM-5** - Zhipu AI model
+- **MiniMax M2.5** - MiniMax model
+- **Claude Sonnet 4.5** - Anthropic Claude (200K context)
+
+## Supported Models
+
+| Model ID | Name | Context Length | Output Length |
+|---------|------|---------------|---------------|
+| `LongCat-Flash-Chat` | LongCat Flash Chat | 128K | 8K |
+| `kimi-k2.5` | Kimi K2.5 | 256K | 8K |
+| `glm-5` | GLM-5 | 128K | 8K |
+| `MiniMax-M2.5` | MiniMax M2.5 | 128K | 8K |
+| `claude-sonnet-4.5` | Claude Sonnet 4.5 | 200K | 8K |
+
+## Troubleshooting
+
+### 1. Check config file
+
+Ensure the config file exists and contains AUTHORIZATION:
+
+```bash
+cat ~/.config/mcopilot-cli/.config.yaml
+```
+
+### 2. Check plugin loading
+
+View logs when starting OpenCode:
+
+```bash
+opencode --verbose
+```
+
+### 3. Test API manually
+
+```bash
+curl https://mcli.sankuai.com/v1/models \
+  -H "x-api-key: $(grep AUTHORIZATION ~/.config/mcopilot-cli/.config.yaml | awk '{print $2}')" \
+  -H "x-working-dir: $HOME"
+```
+
+### Common Issues
+
+**Q: Plugin shows "Failed to load API key"**
+- Check if `~/.config/mcopilot-cli/.config.yaml` exists
+- Check if file contains `AUTHORIZATION` field
+- Check file permissions
+
+**Q: Empty model list**
+- Ensure `/connect` was run and CatPaw AI was selected
+- Check network connection
+
+**Q: 401/403 errors**
+- API key may be expired, try updating config file
+- Check if `x-working-dir` header is correct
+
+## Development
+
+### Project Structure
+
+```
+opencode-catpaw-auth/
+├── index.ts          # Plugin entry
+├── package.json      # Dependencies
+├── tsconfig.json     # TypeScript config
+├── src/
+│   ├── plugin.ts     # Core plugin logic
+│   ├── config.ts     # Config file reading
+│   ├── request.ts    # Request handling
+│   └── types.ts      # Type definitions
+└── README.md
+```
+
+### Local Testing
+
+1. Install dependencies:
+
+```bash
+bun install
+```
+
+2. Type check:
+
+```bash
+bun run check
+```
+
+3. Use `file://` protocol in OpenCode config to reference local path
+
+### Scripts
+
+```bash
+bun run dev      # Development mode with watch
+bun run check    # TypeScript type check
+bun run clean    # Clean dependencies
+```
+
+## How It Works
+
+This plugin follows the OpenCode plugin architecture:
+
+1. **Config Hook**: Registers CatPaw as a provider with model definitions
+2. **Auth Loader**: Reads API key from mcopilot-cli config file
+3. **Custom Fetch**: Intercepts requests to `mcli.sankuai.com` and injects required headers
+
+Inspired by [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth).
+
+## License
+
+MIT © [zu1k](https://github.com/zu1k)
+
+## Links
+
+- [OpenCode Documentation](https://opencode.ai/docs)
+- [OpenCode Providers](https://opencode.ai/docs/providers)
+- [npm package](https://www.npmjs.com/package/@zu1k/opencode-catpaw-auth)
+- [GitHub Repository](https://github.com/zu1k/opencode-catpaw-auth)

package/index.ts

@@ -0,0 +1 @@
+export { CatPawAuthPlugin } from "./src/plugin";

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "opencode-catpaw-auth",
+  "module": "index.ts",
+  "version": "1.1.0",
+  "description": "CatPaw AI provider plugin for OpenCode - Auto-auth from mcopilot-cli config",
+  "author": "zu1k",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zu1k/opencode-catpaw-auth.git"
+  },
+  "homepage": "https://github.com/zu1k/opencode-catpaw-auth#readme",
+  "bugs": {
+    "url": "https://github.com/zu1k/opencode-catpaw-auth/issues"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "catpaw",
+    "ai",
+    "provider"
+  ],
+  "files": [
+    "index.ts",
+    "src"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "dev": "bun run --watch index.ts",
+    "check": "tsc --noEmit",
+    "clean": "rm -rf node_modules bun.lock"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/js-yaml": "^4.0.9"
+  },
+  "peerDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.2.10",
+    "js-yaml": "^4.1.0"
+  }
+}

package/src/config.ts

@@ -0,0 +1,43 @@
+import { readFileSync, existsSync } from "fs";
+import { join, homedir } from "path";
+import yaml from "js-yaml";
+
+const CONFIG_PATH = join(homedir(), ".config", "mcopilot-cli", ".config.yaml");
+
+/**
+ * 从 mcopilot-cli 配置文件中加载 API key
+ * 配置文件路径: ~/.config/mcopilot-cli/.config.yaml
+ */
+export async function loadApiKeyFromConfig(): Promise<string | null> {
+  try {
+    // 检查配置文件是否存在
+    if (!existsSync(CONFIG_PATH)) {
+      console.error(`CatPaw config file not found: ${CONFIG_PATH}`);
+      return null;
+    }
+
+    // 读取并解析 YAML
+    const content = readFileSync(CONFIG_PATH, "utf-8");
+    const config = yaml.load(content) as Record<string, unknown>;
+
+    // 获取 AUTHORIZATION 字段
+    const apiKey = config?.AUTHORIZATION;
+    
+    if (typeof apiKey !== "string" || !apiKey) {
+      console.error("AUTHORIZATION not found in config file");
+      return null;
+    }
+
+    return apiKey;
+  } catch (error) {
+    console.error("Failed to load CatPaw API key:", error);
+    return null;
+  }
+}
+
+/**
+ * 获取配置文件路径（用于调试）
+ */
+export function getConfigPath(): string {
+  return CONFIG_PATH;
+}

package/src/plugin.ts

@@ -0,0 +1,116 @@
+import type { PluginContext, PluginResult, Provider } from "./types";
+import { loadApiKeyFromConfig } from "./config";
+import { isCatPawRequest, prepareCatPawRequest } from "./request";
+
+export const CATPAW_PROVIDER_ID = "catpaw";
+
+/**
+ * CatPaw AI Provider Plugin for OpenCode
+ *
+ * This plugin automatically:
+ * 1. Loads API key from ~/.config/mcopilot-cli/.config.yaml
+ * 2. Injects required headers (x-api-key, x-working-dir)
+ * 3. Supports multiple models: LongCat-Flash-Chat, kimi-k2.5, glm-5, MiniMax-M2.5, claude-sonnet-4.5
+ */
+export const CatPawAuthPlugin = async ({ client }: PluginContext): Promise<PluginResult> => ({
+  config: async (config) => {
+    // 配置 CatPaw provider
+    config.provider = config.provider || {};
+    config.provider[CATPAW_PROVIDER_ID] = {
+      npm: "@ai-sdk/openai-compatible",
+      name: "CatPaw AI",
+      options: {
+        baseURL: "https://mcli.sankuai.com/v1",
+      },
+      models: {
+        "LongCat-Flash-Chat": {
+          name: "LongCat Flash Chat",
+          limit: {
+            context: 256000,
+            output: 8192,
+          },
+        },
+        "kimi-k2.5": {
+          name: "Kimi K2.5",
+          limit: {
+            context: 256000,
+            output: 8192,
+          },
+        },
+        "glm-5": {
+          name: "GLM-5",
+          limit: {
+            context: 200000,
+            output: 8192,
+          },
+        },
+        "MiniMax-M2.5": {
+          name: "MiniMax M2.5",
+          limit: {
+            context: 200000,
+            output: 8192,
+          },
+        },
+        "claude-sonnet-4.5": {
+          name: "Claude Sonnet 4.5",
+          limit: {
+            context: 200000,
+            output: 8192,
+          },
+        },
+      },
+    };
+  },
+  auth: {
+    provider: CATPAW_PROVIDER_ID,
+    loader: async (getAuth, provider: Provider) => {
+      // 从配置文件加载 API key
+      const apiKey = await loadApiKeyFromConfig();
+
+      if (!apiKey) {
+        client.app.log({
+          body: {
+            service: "catpaw-auth",
+            level: "error",
+            message: "Failed to load API key from ~/.config/mcopilot-cli/.config.yaml",
+          },
+        });
+        return null;
+      }
+
+      const workingDir = process.env.HOME || process.env.USERPROFILE || "/";
+
+      client.app.log({
+        body: {
+          service: "catpaw-auth",
+          level: "info",
+          message: "CatPaw auth loaded successfully",
+          extra: { workingDir },
+        },
+      });
+
+      return {
+        apiKey: "", // 使用自定义 fetch，不需要标准 apiKey
+        async fetch(input, init) {
+          // 只处理 CatPaw 相关的请求
+          if (!isCatPawRequest(input)) {
+            return fetch(input, init);
+          }
+
+          // 准备请求，注入必要的 headers
+          const { request, init: requestInit } = prepareCatPawRequest(input, init, apiKey, workingDir);
+
+          // 发送请求
+          return fetch(request, requestInit);
+        },
+      };
+    },
+    methods: [
+      {
+        provider: CATPAW_PROVIDER_ID,
+        label: "Auto-config from mcopilot-cli",
+        type: "api",
+      },
+    ],
+  },
+});

package/src/request.ts

@@ -0,0 +1,47 @@
+/**
+ * 检查请求是否是 CatPaw API 请求
+ */
+export function isCatPawRequest(input: RequestInfo): boolean {
+  const url = typeof input === "string" ? input : input.url;
+  return url.includes("mcli.sankuai.com");
+}
+
+/**
+ * 准备 CatPaw 请求，注入必要的 headers
+ */
+export function prepareCatPawRequest(
+  input: RequestInfo,
+  init: RequestInit | undefined,
+  apiKey: string,
+  workingDir: string
+): { request: RequestInfo; init: RequestInit } {
+  // 解析原始 URL
+  const url = typeof input === "string" ? input : input.url;
+  
+  // 准备 headers
+  const headers = new Headers(init?.headers);
+  
+  // 移除可能冲突的 headers
+  headers.delete("host");
+  headers.delete("authorization");
+  
+  // 注入 CatPaw 必需的 headers
+  headers.set("x-api-key", apiKey);
+  headers.set("x-working-dir", workingDir);
+  
+  // 确保 Content-Type 存在
+  if (!headers.has("Content-Type") && !headers.has("content-type")) {
+    headers.set("Content-Type", "application/json");
+  }
+
+  // 创建新的请求配置
+  const requestInit: RequestInit = {
+    ...init,
+    headers,
+  };
+
+  return {
+    request: input,
+    init: requestInit,
+  };
+}

package/src/types.ts

@@ -0,0 +1,85 @@
+/**
+ * OpenCode Plugin Types
+ * 这些类型定义基于 @opencode-ai/plugin
+ */
+
+export interface PluginContext {
+  project: {
+    id: string;
+    name: string;
+    directory: string;
+  };
+  directory: string;
+  worktree: string;
+  client: PluginClient;
+}
+
+export interface PluginClient {
+  app: {
+    log: (params: {
+      body: {
+        service: string;
+        level: "debug" | "info" | "warn" | "error";
+        message: string;
+        extra?: Record<string, unknown>;
+      };
+    }) => Promise<void>;
+  };
+}
+
+export interface PluginResult {
+  config?: (config: Config) => Promise<void> | void;
+  auth?: {
+    provider: string;
+    loader: (
+      getAuth: GetAuth,
+      provider: Provider
+    ) => Promise<LoaderResult | null>;
+    methods: AuthMethod[];
+  };
+}
+
+export interface Config {
+  provider?: Record<string, ProviderConfig>;
+  command?: Record<string, CommandConfig>;
+}
+
+export interface ProviderConfig {
+  npm?: string;
+  name?: string;
+  options?: Record<string, unknown>;
+  models?: Record<string, ModelConfig>;
+}
+
+export interface ModelConfig {
+  name?: string;
+  limit?: {
+    context?: number;
+    output?: number;
+  };
+  options?: Record<string, unknown>;
+}
+
+export interface CommandConfig {
+  description: string;
+  template: string;
+}
+
+export interface Provider {
+  options?: Record<string, unknown>;
+  models?: Record<string, ModelConfig>;
+}
+
+export interface AuthMethod {
+  provider: string;
+  label: string;
+  type: "oauth" | "api" | "token";
+  authorize?: () => Promise<unknown>;
+}
+
+export type GetAuth = () => Promise<unknown>;
+
+export interface LoaderResult {
+  apiKey: string;
+  fetch: (input: RequestInfo, init?: RequestInit) => Promise<Response>;
+}