opencode-plugin-tsaperture 0.1.1

package/README.md

@@ -0,0 +1,59 @@
+# OpenCode Tailscale Aperture Plugin
+
+Automatically populate models from Tailscale Aperture.
+
+## Configuration
+
+Configure the Aperture base URL using one of these methods (in order of precedence):
+
+### 1. Plugin Options (opencode.json)
+
+```json
+{
+  "plugins": [
+    ["opencode-plugin-tsaperture"]
+  ]
+}
+```
+
+### 2. Environment Variable
+
+```bash
+export APERTURE_BASE_URL="http://ai.my-tailnet.ts.net"
+```
+
+### 3. Config File (aperture.json)
+
+Create `aperture.json` in the opencode config directory:
+
+**macOS:**
+```bash
+~/Library/Application\ Support/opencode/aperture.json
+```
+
+**Linux:**
+```bash
+~/.config/opencode/aperture.json
+```
+
+**Windows:**
+```
+%APPDATA%\opencode\aperture.json
+```
+
+Contents:
+```json
+{
+  "baseUrl": "http://ai.my-tailnet.ts.net",
+  "apiKey": ""
+}
+```
+
+`apiKey` is optional. Set it when your Aperture endpoint requires bearer auth. If omitted, the plugin passes an empty key to the OpenAI-compatible provider.
+
+## Usage
+
+Once configured, models will be available via the plugin tools:
+
+- `/list_aperture_models` - List available models from Aperture
+- `/get_aperture_model modelId=<id>` - Get model details

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export declare const TailscaleAperturePlugin: Plugin;
+export default TailscaleAperturePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA+MlD,eAAO,MAAM,uBAAuB,EAAE,MAkJrC,CAAC;AAEF,eAAe,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,287 @@
+import { tool } from "@opencode-ai/plugin";
+import { homedir } from "os";
+import { join } from "path";
+import { readFile } from "fs/promises";
+import { platform } from "process";
+function normalizeBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/, "").replace(/\/v1$/, "");
+}
+function getModelDefaults(model) {
+    const id = model.id.toLowerCase();
+    const providerID = model.metadata?.provider?.id?.toLowerCase();
+    const providerName = model.metadata?.provider?.name?.toLowerCase();
+    const isZai = id.includes("glm")
+        || providerID === "zai"
+        || providerID === "z.ai"
+        || providerID === "zai-coding-plan"
+        || providerName === "z.ai"
+        || providerName === "zai-coding-plan";
+    const isKimi = id.includes("kimi")
+        || providerID === "kimi"
+        || providerID === "kimi-for-coding"
+        || providerName === "kimi"
+        || providerName === "kimi-for-coding";
+    if (isZai) {
+        return {
+            limit: {
+                context: 200_000,
+                output: 8_192,
+            },
+            reasoning: true,
+            temperature: true,
+            tool_call: true,
+            modalities: {
+                input: ["text"],
+                output: ["text"],
+            },
+            interleaved: {
+                field: "reasoning_content",
+            },
+            options: {
+                thinking: {
+                    type: "enabled",
+                    clear_thinking: false,
+                },
+            },
+        };
+    }
+    if (isKimi) {
+        return {
+            limit: {
+                context: 200_000,
+                output: 128_000,
+            },
+            reasoning: true,
+            temperature: true,
+            tool_call: true,
+            modalities: {
+                input: ["text"],
+                output: ["text"],
+            },
+            interleaved: {
+                field: "reasoning_content",
+            },
+            options: {
+                thinking: {
+                    type: "enabled",
+                    clear_thinking: false,
+                },
+            },
+            headers: {
+                "User-Agent": "KimiCLI/1.3",
+            },
+        };
+    }
+    return {
+        limit: {
+            context: 128_000,
+            output: 8_192,
+        },
+        reasoning: false,
+        temperature: true,
+        tool_call: true,
+        modalities: {
+            input: ["text"],
+            output: ["text"],
+        },
+        interleaved: {
+            field: "reasoning_content",
+        },
+        options: {
+            thinking: {
+                type: "enabled",
+                clear_thinking: false,
+            },
+        },
+    };
+}
+async function fetchApertureModels(baseUrl) {
+    const response = await fetch(`${baseUrl}/v1/models`);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch models: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    return data.data || [];
+}
+function getOpenCodeConfigDirs() {
+    const home = homedir();
+    const dirs = [];
+    if (platform === "win32") {
+        dirs.push(join(process.env.APPDATA || process.env.LOCALAPPDATA || home, "opencode"));
+    }
+    else if (platform === "darwin") {
+        const xdgConfig = process.env.XDG_CONFIG_HOME;
+        if (xdgConfig) {
+            dirs.push(join(xdgConfig, "opencode"));
+        }
+        dirs.push(join(home, ".config", "opencode"));
+        dirs.push(join(home, "Library", "Application Support", "opencode"));
+    }
+    else {
+        const xdgConfig = process.env.XDG_CONFIG_HOME;
+        if (xdgConfig) {
+            dirs.push(join(xdgConfig, "opencode"));
+        }
+        dirs.push(join(home, ".config", "opencode"));
+    }
+    return dirs;
+}
+const openCodeConfigDirs = getOpenCodeConfigDirs();
+async function loadApertureConfig() {
+    for (const configDir of openCodeConfigDirs) {
+        const configPath = join(configDir, "aperture.json");
+        try {
+            const content = await readFile(configPath, "utf-8");
+            console.log(`[TailscaleAperture] Loaded config from ${configPath}`);
+            return JSON.parse(content);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                console.warn(`[TailscaleAperture] Failed to read ${configPath}:`, error);
+            }
+        }
+    }
+    return {};
+}
+export const TailscaleAperturePlugin = async (_ctx, options) => {
+    const fileConfig = await loadApertureConfig();
+    const rawBaseUrl = options?.baseUrl || process.env.APERTURE_BASE_URL || fileConfig.baseUrl;
+    const apiKey = options?.apiKey || process.env.APERTURE_API_KEY || fileConfig.apiKey || "";
+    if (!rawBaseUrl) {
+        console.warn("[TailscaleAperture] No baseUrl configured. Set APERTURE_BASE_URL, add baseUrl to plugin options, or create aperture.json in opencode config directory.");
+        return {};
+    }
+    const baseUrl = normalizeBaseUrl(rawBaseUrl);
+    let discoveredModels = [];
+    let modelsLoaded = false;
+    async function loadModels(refresh = false) {
+        if (!refresh && modelsLoaded) {
+            return discoveredModels;
+        }
+        discoveredModels = await fetchApertureModels(baseUrl);
+        modelsLoaded = true;
+        return discoveredModels;
+    }
+    try {
+        discoveredModels = await loadModels(true);
+        if (discoveredModels.length === 0) {
+            console.warn("[TailscaleAperture] No models found");
+        }
+        else {
+            console.log(`[TailscaleAperture] Discovered ${discoveredModels.length} models from ${baseUrl}`);
+        }
+    }
+    catch (error) {
+        console.warn("[TailscaleAperture] Failed to preload models:", error);
+    }
+    return {
+        config: async (config) => {
+            try {
+                config.provider ??= {};
+                if (discoveredModels.length === 0) {
+                    return;
+                }
+                const existingProvider = config.provider.aperture ?? {};
+                config.provider.aperture = {
+                    ...existingProvider,
+                    npm: existingProvider.npm ?? "@ai-sdk/openai-compatible",
+                    name: existingProvider.name ?? "Tailscale Aperture",
+                    options: {
+                        ...existingProvider.options,
+                        baseURL: `${baseUrl}/v1`,
+                        apiKey: existingProvider.options?.apiKey ?? apiKey,
+                    },
+                    models: {
+                        ...existingProvider.models,
+                    },
+                };
+                // Add discovered models while preserving explicit user overrides.
+                for (const model of discoveredModels) {
+                    const existingModel = config.provider.aperture.models[model.id] ?? {};
+                    const defaults = getModelDefaults(model);
+                    config.provider.aperture.models[model.id] = {
+                        ...defaults,
+                        ...existingModel,
+                        limit: {
+                            ...defaults.limit,
+                            ...existingModel.limit,
+                        },
+                        modalities: {
+                            ...defaults.modalities,
+                            ...existingModel.modalities,
+                        },
+                        ...(defaults.interleaved || existingModel.interleaved ? {
+                            interleaved: existingModel.interleaved ?? defaults.interleaved,
+                        } : {}),
+                        ...(defaults.options || existingModel.options ? {
+                            options: {
+                                ...defaults.options,
+                                ...existingModel.options,
+                                ...(defaults.options?.thinking || existingModel.options?.thinking ? {
+                                    thinking: {
+                                        ...defaults.options?.thinking,
+                                        ...existingModel.options?.thinking,
+                                    },
+                                } : {}),
+                            },
+                        } : {}),
+                        ...(defaults.headers || existingModel.headers ? {
+                            headers: {
+                                ...defaults.headers,
+                                ...existingModel.headers,
+                            },
+                        } : {}),
+                        id: model.id,
+                        name: existingModel.name ?? model.id,
+                    };
+                }
+                console.log(`[TailscaleAperture] Registered ${discoveredModels.length} models`);
+            }
+            catch (error) {
+                console.error("[TailscaleAperture] Failed to register models:", error);
+            }
+        },
+        tool: {
+            list_aperture_models: tool({
+                description: "List available models from Tailscale Aperture",
+                args: {
+                    refresh: tool.schema.boolean().optional().describe("Refresh the cached Aperture model list before returning it"),
+                },
+                async execute(args) {
+                    try {
+                        const models = await loadModels(args.refresh ?? false);
+                        return JSON.stringify({
+                            models,
+                            count: models.length,
+                        }, null, 2);
+                    }
+                    catch (error) {
+                        return JSON.stringify({ error: String(error) });
+                    }
+                },
+            }),
+            get_aperture_model: tool({
+                description: "Get details for a specific Aperture model",
+                args: {
+                    modelId: tool.schema.string().describe("Model ID"),
+                    refresh: tool.schema.boolean().optional().describe("Refresh the cached Aperture model list before looking up the model"),
+                },
+                async execute(args) {
+                    try {
+                        const models = await loadModels(args.refresh ?? false);
+                        const model = models.find(m => m.id === args.modelId);
+                        if (!model) {
+                            return JSON.stringify({ error: `Model ${args.modelId} not found` });
+                        }
+                        return JSON.stringify({ model }, null, 2);
+                    }
+                    catch (error) {
+                        return JSON.stringify({ error: String(error) });
+                    }
+                },
+            }),
+        },
+    };
+};
+export default TailscaleAperturePlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "opencode-plugin-tsaperture",
+  "version": "0.1.1",
+  "description": "OpenCode plugin to automatically populate models from Tailscale Aperture API",
+  "homepage": "https://github.com/SharkyRawr/opencode-plugin-tsaperture",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "opencode",
+    "plugin",
+    "tailscale",
+    "aperture"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.3.10"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "@types/node": "^20.19.37"
+  },
+  "peerDependencies": {
+    "opencode-ai": "^1.3.7"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch"
+  }
+}

package/src/index.ts

@@ -0,0 +1,356 @@
+import type { Plugin } from "@opencode-ai/plugin";
+import { tool } from "@opencode-ai/plugin";
+import { homedir } from "os";
+import { join } from "path";
+import { readFile } from "fs/promises";
+import { platform } from "process";
+
+interface ApertureModel {
+  id: string;
+  object: string;
+  created: number;
+  owned_by: string;
+  metadata?: {
+    provider?: {
+      id: string;
+      name: string;
+      description?: string;
+    };
+  };
+}
+
+interface ApertureResponse {
+  object: string;
+  data: ApertureModel[];
+}
+
+interface ApertureConfig {
+  baseUrl?: string;
+  apiKey?: string;
+}
+
+type ModelConfig = {
+  id: string;
+  name: string;
+  limit: {
+    context: number;
+    output: number;
+  };
+  reasoning: boolean;
+  temperature: boolean;
+  tool_call: boolean;
+  modalities: {
+    input: Array<"text">;
+    output: Array<"text">;
+  };
+  interleaved?: true | {
+    field: "reasoning_content" | "reasoning_details";
+  };
+  options?: {
+    thinking?: {
+      type?: string;
+      clear_thinking?: boolean;
+    };
+  };
+  headers?: Record<string, string>;
+};
+
+function normalizeBaseUrl(baseUrl: string): string {
+  return baseUrl.replace(/\/+$/, "").replace(/\/v1$/, "");
+}
+
+function getModelDefaults(model: ApertureModel): Omit<ModelConfig, "id" | "name"> {
+  const id = model.id.toLowerCase();
+  const providerID = model.metadata?.provider?.id?.toLowerCase();
+  const providerName = model.metadata?.provider?.name?.toLowerCase();
+  const isZai = id.includes("glm")
+    || providerID === "zai"
+    || providerID === "z.ai"
+    || providerID === "zai-coding-plan"
+    || providerName === "z.ai"
+    || providerName === "zai-coding-plan";
+  const isKimi = id.includes("kimi")
+    || providerID === "kimi"
+    || providerID === "kimi-for-coding"
+    || providerName === "kimi"
+    || providerName === "kimi-for-coding";
+
+  if (isZai) {
+    return {
+      limit: {
+        context: 200_000,
+        output: 8_192,
+      },
+      reasoning: true,
+      temperature: true,
+      tool_call: true,
+      modalities: {
+        input: ["text"],
+        output: ["text"],
+      },
+      interleaved: {
+        field: "reasoning_content",
+      },
+      options: {
+        thinking: {
+          type: "enabled",
+          clear_thinking: false,
+        },
+      },
+    };
+  }
+
+  if (isKimi) {
+    return {
+      limit: {
+        context: 200_000,
+        output: 128_000,
+      },
+      reasoning: true,
+      temperature: true,
+      tool_call: true,
+      modalities: {
+        input: ["text"],
+        output: ["text"],
+      },
+      interleaved: {
+        field: "reasoning_content",
+      },
+      options: {
+        thinking: {
+          type: "enabled",
+          clear_thinking: false,
+        },
+      },
+      headers: {
+        "User-Agent": "KimiCLI/1.3",
+      },
+    };
+  }
+
+  return {
+    limit: {
+      context: 128_000,
+      output: 8_192,
+    },
+    reasoning: false,
+    temperature: true,
+    tool_call: true,
+    modalities: {
+      input: ["text"],
+      output: ["text"],
+    },
+    interleaved: {
+      field: "reasoning_content",
+    },
+    options: {
+      thinking: {
+        type: "enabled",
+        clear_thinking: false,
+      },
+    },
+  };
+}
+
+async function fetchApertureModels(baseUrl: string): Promise<ApertureModel[]> {
+  const response = await fetch(`${baseUrl}/v1/models`);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch models: ${response.status} ${response.statusText}`);
+  }
+
+  const data = await response.json() as ApertureResponse;
+  return data.data || [];
+}
+
+function getOpenCodeConfigDirs(): string[] {
+  const home = homedir();
+  const dirs: string[] = [];
+
+  if (platform === "win32") {
+    dirs.push(join(process.env.APPDATA || process.env.LOCALAPPDATA || home, "opencode"));
+  } else if (platform === "darwin") {
+    const xdgConfig = process.env.XDG_CONFIG_HOME;
+    if (xdgConfig) {
+      dirs.push(join(xdgConfig, "opencode"));
+    }
+    dirs.push(join(home, ".config", "opencode"));
+    dirs.push(join(home, "Library", "Application Support", "opencode"));
+  } else {
+    const xdgConfig = process.env.XDG_CONFIG_HOME;
+    if (xdgConfig) {
+      dirs.push(join(xdgConfig, "opencode"));
+    }
+    dirs.push(join(home, ".config", "opencode"));
+  }
+
+  return dirs;
+}
+
+const openCodeConfigDirs = getOpenCodeConfigDirs();
+
+async function loadApertureConfig(): Promise<ApertureConfig> {
+  for (const configDir of openCodeConfigDirs) {
+    const configPath = join(configDir, "aperture.json");
+    try {
+      const content = await readFile(configPath, "utf-8");
+      console.log(`[TailscaleAperture] Loaded config from ${configPath}`);
+      return JSON.parse(content) as ApertureConfig;
+    } catch (error) {
+      if ((error as NodeJS.ErrnoException).code !== "ENOENT") {
+        console.warn(`[TailscaleAperture] Failed to read ${configPath}:`, error);
+      }
+    }
+  }
+
+  return {};
+}
+
+export const TailscaleAperturePlugin: Plugin = async (_ctx, options) => {
+  const fileConfig = await loadApertureConfig();
+  const rawBaseUrl = (options?.baseUrl as string) || process.env.APERTURE_BASE_URL || fileConfig.baseUrl;
+  const apiKey = (options?.apiKey as string) || process.env.APERTURE_API_KEY || fileConfig.apiKey || "";
+
+  if (!rawBaseUrl) {
+    console.warn("[TailscaleAperture] No baseUrl configured. Set APERTURE_BASE_URL, add baseUrl to plugin options, or create aperture.json in opencode config directory.");
+    return {};
+  }
+
+  const baseUrl = normalizeBaseUrl(rawBaseUrl);
+  let discoveredModels: ApertureModel[] = [];
+  let modelsLoaded = false;
+
+  async function loadModels(refresh = false): Promise<ApertureModel[]> {
+    if (!refresh && modelsLoaded) {
+      return discoveredModels;
+    }
+
+    discoveredModels = await fetchApertureModels(baseUrl);
+    modelsLoaded = true;
+    return discoveredModels;
+  }
+
+  try {
+    discoveredModels = await loadModels(true);
+    if (discoveredModels.length === 0) {
+      console.warn("[TailscaleAperture] No models found");
+    } else {
+      console.log(`[TailscaleAperture] Discovered ${discoveredModels.length} models from ${baseUrl}`);
+    }
+  } catch (error) {
+    console.warn("[TailscaleAperture] Failed to preload models:", error);
+  }
+
+  return {
+    config: async (config: any) => {
+      try {
+        config.provider ??= {};
+
+        if (discoveredModels.length === 0) {
+          return;
+        }
+
+        const existingProvider = config.provider.aperture ?? {};
+        config.provider.aperture = {
+          ...existingProvider,
+          npm: existingProvider.npm ?? "@ai-sdk/openai-compatible",
+          name: existingProvider.name ?? "Tailscale Aperture",
+          options: {
+            ...existingProvider.options,
+            baseURL: `${baseUrl}/v1`,
+            apiKey: existingProvider.options?.apiKey ?? apiKey,
+          },
+          models: {
+            ...existingProvider.models,
+          },
+        };
+
+        // Add discovered models while preserving explicit user overrides.
+        for (const model of discoveredModels) {
+          const existingModel = config.provider.aperture.models[model.id] ?? {};
+          const defaults = getModelDefaults(model);
+          config.provider.aperture.models[model.id] = {
+            ...defaults,
+            ...existingModel,
+            limit: {
+              ...defaults.limit,
+              ...existingModel.limit,
+            },
+            modalities: {
+              ...defaults.modalities,
+              ...existingModel.modalities,
+            },
+            ...(defaults.interleaved || existingModel.interleaved ? {
+              interleaved: existingModel.interleaved ?? defaults.interleaved,
+            } : {}),
+            ...(defaults.options || existingModel.options ? {
+              options: {
+                ...defaults.options,
+                ...existingModel.options,
+                ...(defaults.options?.thinking || existingModel.options?.thinking ? {
+                  thinking: {
+                    ...defaults.options?.thinking,
+                    ...existingModel.options?.thinking,
+                  },
+                } : {}),
+              },
+            } : {}),
+            ...(defaults.headers || existingModel.headers ? {
+              headers: {
+                ...defaults.headers,
+                ...existingModel.headers,
+              },
+            } : {}),
+            id: model.id,
+            name: existingModel.name ?? model.id,
+          };
+        }
+
+        console.log(`[TailscaleAperture] Registered ${discoveredModels.length} models`);
+      } catch (error) {
+        console.error("[TailscaleAperture] Failed to register models:", error);
+      }
+    },
+
+    tool: {
+      list_aperture_models: tool({
+        description: "List available models from Tailscale Aperture",
+        args: {
+          refresh: tool.schema.boolean().optional().describe("Refresh the cached Aperture model list before returning it"),
+        },
+        async execute(args) {
+          try {
+            const models = await loadModels(args.refresh ?? false);
+            return JSON.stringify({
+              models,
+              count: models.length,
+            }, null, 2);
+          } catch (error) {
+            return JSON.stringify({ error: String(error) });
+          }
+        },
+      }),
+
+      get_aperture_model: tool({
+        description: "Get details for a specific Aperture model",
+        args: {
+          modelId: tool.schema.string().describe("Model ID"),
+          refresh: tool.schema.boolean().optional().describe("Refresh the cached Aperture model list before looking up the model"),
+        },
+        async execute(args) {
+          try {
+            const models = await loadModels(args.refresh ?? false);
+            const model = models.find(m => m.id === args.modelId);
+            if (!model) {
+              return JSON.stringify({ error: `Model ${args.modelId} not found` });
+            }
+            return JSON.stringify({ model }, null, 2);
+          } catch (error) {
+            return JSON.stringify({ error: String(error) });
+          }
+        },
+      }),
+    },
+  };
+};
+
+export default TailscaleAperturePlugin;

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "strictBindCallApply": true,
+    "strictPropertyInitialization": true,
+    "noImplicitThis": true,
+    "alwaysStrict": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}