opencode-custom-api 0.0.0-stage → 0.1.0

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.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 OpenCode community
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,158 @@
1
- # Temporary Holding Version
1
+ # opencode-custom-api
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ An OpenCode V2 server plugin that discovers chat models from self-hosted or third-party OpenAI-compatible and Anthropic-compatible endpoints and registers them as native OpenCode providers.
4
+
5
+ ## Requirements
6
+
7
+ - OpenCode with `@opencode/plugin` V2 (this release targets 2.3.x)
8
+ - Node.js 20+ when building or testing the npm package
9
+ - A model-list endpoint returning an array, `{ "data": [] }`, `{ "models": [] }`, or `{ "models": { "id": {...} } }`
10
+
11
+ ## Install
12
+
13
+ After the package is published to npm, install it with:
14
+
15
+ ```sh
16
+ npm install opencode-custom-api
17
+ ```
18
+
19
+ For local development, clone this repository and run `npm install && npm run build`. Then use the plugin directory path in `opencode.jsonc`; paths may be relative to the config file, absolute, or `file://` URLs. A local directory with this package's `name` and `exports` is loaded through those exports:
20
+
21
+ ```jsonc
22
+ {
23
+ "$schema": "https://opencode.ai/config.json",
24
+ "plugins": [
25
+ {
26
+ "package": "./path/to/opencode-custom-api",
27
+ "options": { "endpoints": [] }
28
+ }
29
+ ]
30
+ }
31
+ ```
32
+
33
+ ## Configuration
34
+
35
+ Credentials are **references to environment variables**, never literal API keys:
36
+
37
+ ```jsonc
38
+ {
39
+ "$schema": "https://opencode.ai/config.json",
40
+ "plugins": [
41
+ {
42
+ "package": "opencode-custom-api",
43
+ "options": {
44
+ "endpoints": [
45
+ {
46
+ "id": "local-openai",
47
+ "name": "Local OpenAI API",
48
+ "baseURL": "http://127.0.0.1:8000/v1",
49
+ "protocol": "openai-compatible",
50
+ "apiKey": { "env": "LOCAL_OPENAI_API_KEY" },
51
+ "timeoutMs": 10000,
52
+ "cacheTtlMs": 300000,
53
+ "refreshIntervalMs": 0,
54
+ "headers": { "X-Tenant": { "env": "TENANT_ID" } },
55
+ "catalog": {
56
+ "my-model": {
57
+ "context": 131072,
58
+ "max_output_tokens": 8192,
59
+ "capabilities": {
60
+ "input": ["text", "image"],
61
+ "tools": true,
62
+ "reasoning": false
63
+ }
64
+ }
65
+ }
66
+ },
67
+ {
68
+ "id": "private-anthropic",
69
+ "baseURL": "https://gateway.example.com",
70
+ "protocol": "anthropic-compatible",
71
+ "apiKey": { "env": "PRIVATE_ANTHROPIC_KEY" }
72
+ }
73
+ ]
74
+ }
75
+ }
76
+ ]
77
+ }
78
+ ```
79
+
80
+ ### Endpoint options
81
+
82
+ | Option | Required | Default | Meaning |
83
+ |---|---:|---:|---|
84
+ | `id` | yes | — | Unique provider ID (`a-z`, digits, `.`, `_`, `-`) |
85
+ | `baseURL` | yes | — | HTTP(S) provider base URL |
86
+ | `protocol` | yes | — | `openai-compatible` or `anthropic-compatible` |
87
+ | `name` | no | `id` | Display name |
88
+ | `apiKey` | no | — | `{ "env": "VARIABLE_NAME" }` only |
89
+ | `headers` | no | `{}` | Static strings or env references; avoid literal secrets |
90
+ | `timeoutMs` | no | `10000` | Per discovery request and runtime provider timeout |
91
+ | `cacheTtlMs` | no | `300000` | Fresh-cache lifetime |
92
+ | `refreshIntervalMs` | no | `0` | Background refresh interval; zero/absent disables it |
93
+ | `catalog` | no | `{}` | Small, endpoint-specific metadata enrichment map keyed by model ID |
94
+
95
+ ## Discovery and normalization
96
+
97
+ - If `baseURL` ends in `/v1`, discovery requests `/models` beneath it. Otherwise it tries `/v1/models`, then `/models`.
98
+ - OpenAI-compatible discovery uses `Authorization: Bearer ...`; Anthropic-compatible discovery uses `x-api-key` plus `anthropic-version`.
99
+ - Requests have a timeout and accept cancellation. Cleanup aborts in-flight scheduled refreshes.
100
+ - IDs/names and common context, output, modalities, tools, and reasoning fields are parsed.
101
+ - Image-generation-only entries are excluded; multimodal models that also produce text remain available.
102
+ - Metadata precedence is: explicit endpoint metadata (including explicit `false`) → exact or uniquely normalized endpoint catalog key → narrow conservative heuristic/default.
103
+ - Normalized catalog matching only lowercases, removes a leading `models/`, and normalizes spaces/underscores to hyphens. It does not use substring/fuzzy matching.
104
+ - Conservative defaults are 32,768 context tokens, 4,096 output tokens, text input, no tools, and no reasoning. Only IDs beginning with `o1`…`o9`, or containing the complete word `reasoner`/`reasoning`, infer reasoning.
105
+
106
+ OpenCode V2 already integrates models.dev. This plugin deliberately does **not** download or duplicate its full catalog because the plugin API does not expose a stable safe catalog lookup. The optional per-endpoint `catalog` supplies trusted enrichment. Internally each field records endpoint/catalog/heuristic/default provenance. V2 2.3.x has no `capabilities.reasoning` field, so reasoning is adapted through the official `compatibility.requireReasoning` model field; input and tools map directly to V2 capabilities.
107
+
108
+ ## Cache and refresh
109
+
110
+ Last successful inventories are stored with a version and timestamp using `ctx.storage`; no filesystem path is hard-coded. A valid fresh entry avoids HTTP. On an expired-cache refresh failure, the last successful inventory is used as stale fallback. If no valid cache exists, setup fails rather than registering an invented inventory.
111
+
112
+ Manual refresh interfaces:
113
+
114
+ - Command: `/custom-api-refresh` refreshes all endpoints.
115
+ - Tool: `custom_api_refresh` refreshes all endpoints or one optional endpoint ID and cooperates with session cancellation.
116
+
117
+ Refresh updates captured source data, then calls the official provider and model reload APIs. External HTTP work is always completed before synchronous transform callbacks.
118
+
119
+ ## Security
120
+
121
+ - Put secrets in environment variables and use `{ "env": "..." }`. The plugin never writes resolved keys to storage.
122
+ - Static header strings are supported for non-secret routing values, but config files may be committed; use env references for anything sensitive.
123
+ - Prefer HTTPS for remote endpoints. HTTP is allowed for loopback/private development.
124
+ - Discovery errors can contain URLs and HTTP statuses, but never include request headers.
125
+
126
+ ## Limitations
127
+
128
+ - Compatibility endpoints vary; discovery requires one of the documented response shapes.
129
+ - Metadata names are not standardized. Unknown fields are ignored and conservative defaults apply.
130
+ - The plugin cannot safely query OpenCode's private models.dev internals and intentionally avoids private APIs or monkey patching.
131
+ - Runtime authentication headers are resolved when the plugin loads. Restart OpenCode after rotating environment variables.
132
+ - The refresh command has no arguments; use the tool when refreshing a single endpoint.
133
+
134
+ ## Development
135
+
136
+ ```sh
137
+ npm test
138
+ npm run typecheck
139
+ npm run build
140
+ npm pack --dry-run
141
+ ```
142
+
143
+ ## Publishing
144
+
145
+ The GitHub Actions workflow at `.github/workflows/publish.yml` publishes the package when a GitHub Release is published. For release-triggered runs, the release tag (for example `v0.1.0`) must match the version in `package.json`.
146
+
147
+ Before the first release:
148
+
149
+ 1. Create a GitHub Actions environment named `npm`.
150
+ 2. Add an npm automation or granular access token as the repository or environment secret `NPM_TOKEN`.
151
+ 3. Ensure the token can publish the `opencode-custom-api` package.
152
+ 4. Update `package.json` and `package-lock.json` to the release version, push the change, then publish a matching GitHub Release.
153
+
154
+ The workflow can also be started manually with **Actions → Publish to npm → Run workflow**. Every run installs from the lockfile, tests, type-checks, builds, and publishes with npm provenance.
155
+
156
+ ## License
157
+
158
+ MIT
@@ -0,0 +1,11 @@
1
+ import type { CacheEntry, DiscoveredModel } from "./types.js";
2
+ export interface Storage {
3
+ get(key: string): Promise<unknown>;
4
+ set(key: string, value: unknown): Promise<void>;
5
+ }
6
+ export declare function validCache(value: unknown): value is CacheEntry;
7
+ export declare function loadWithCache(storage: Storage, key: string, ttl: number, loader: () => Promise<DiscoveredModel[]>, now?: number): Promise<{
8
+ models: DiscoveredModel[];
9
+ stale: boolean;
10
+ }>;
11
+ //# sourceMappingURL=cache.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE7D,MAAM,WAAW,OAAO;IAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE;AAahH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAG9D;AACD,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC,EAAE,GAAG,SAAa,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAYlM"}
package/dist/cache.js ADDED
@@ -0,0 +1,40 @@
1
+ const object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
2
+ const positiveInteger = (value) => typeof value === "number" && Number.isSafeInteger(value) && value > 0;
3
+ const provenanceValues = new Set(["endpoint", "catalog", "heuristic", "default"]);
4
+ function validModel(value) {
5
+ if (!object(value))
6
+ return false;
7
+ if (typeof value.id !== "string" || !value.id || typeof value.name !== "string")
8
+ return false;
9
+ if (!positiveInteger(value.context) || !positiveInteger(value.output) || value.output > value.context)
10
+ return false;
11
+ if (!Array.isArray(value.input) || !value.input.every(item => typeof item === "string"))
12
+ return false;
13
+ if (typeof value.tools !== "boolean" || typeof value.reasoning !== "boolean")
14
+ return false;
15
+ if (value.type !== undefined && typeof value.type !== "string")
16
+ return false;
17
+ return object(value.provenance) && Object.values(value.provenance).every(item => typeof item === "string" && provenanceValues.has(item));
18
+ }
19
+ export function validCache(value) {
20
+ if (!object(value))
21
+ return false;
22
+ return value.version === 1 && typeof value.savedAt === "number" && Number.isFinite(value.savedAt) && value.savedAt >= 0 && Array.isArray(value.models) && value.models.every(validModel);
23
+ }
24
+ export async function loadWithCache(storage, key, ttl, loader, now = Date.now()) {
25
+ const cachedValue = await storage.get(key);
26
+ const cached = validCache(cachedValue) ? cachedValue : undefined;
27
+ if (cached && now - cached.savedAt < ttl)
28
+ return { models: cached.models, stale: false };
29
+ try {
30
+ const models = await loader();
31
+ await storage.set(key, { version: 1, savedAt: now, models });
32
+ return { models, stale: false };
33
+ }
34
+ catch (error) {
35
+ if (cached)
36
+ return { models: cached.models, stale: true };
37
+ throw error;
38
+ }
39
+ }
40
+ //# sourceMappingURL=cache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { EndpointOptions, ModelMetadata } from "./types.js";
2
+ export declare function discoveryURLs(baseURL: string): string[];
3
+ export declare function resolveHeaders(endpoint: EndpointOptions): Record<string, string>;
4
+ export declare function parseModels(payload: unknown): ModelMetadata[];
5
+ export declare function discover(endpoint: EndpointOptions, signal?: AbortSignal, fetcher?: typeof fetch): Promise<ModelMetadata[]>;
6
+ //# sourceMappingURL=discovery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAIhE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAGvD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBhF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,CAM7D;AAUD,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,OAAO,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAcvI"}
@@ -0,0 +1,64 @@
1
+ const object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
2
+ export function discoveryURLs(baseURL) {
3
+ const base = baseURL.replace(/\/+$/, "");
4
+ return /\/v1$/i.test(base) ? [`${base}/models`] : [`${base}/v1/models`, `${base}/models`];
5
+ }
6
+ export function resolveHeaders(endpoint) {
7
+ const result = { Accept: "application/json" };
8
+ if (endpoint.apiKey) {
9
+ const value = process.env[endpoint.apiKey.env];
10
+ if (value) {
11
+ if (endpoint.protocol === "anthropic-compatible") {
12
+ result["x-api-key"] = value;
13
+ result["anthropic-version"] = "2023-06-01";
14
+ }
15
+ else
16
+ result.Authorization = `Bearer ${value}`;
17
+ }
18
+ }
19
+ for (const [key, source] of Object.entries(endpoint.headers ?? {})) {
20
+ const value = typeof source === "string" ? source : process.env[source.env];
21
+ if (value !== undefined)
22
+ result[key] = value;
23
+ }
24
+ return result;
25
+ }
26
+ export function parseModels(payload) {
27
+ let value = payload;
28
+ if (object(payload))
29
+ value = payload.data ?? payload.models;
30
+ if (Array.isArray(value))
31
+ return value.filter(object);
32
+ if (object(value))
33
+ return Object.entries(value).flatMap(([id, item]) => object(item) ? [{ id, ...item }] : []);
34
+ throw new Error("Unsupported model-list response shape");
35
+ }
36
+ function combinedSignal(timeoutMs, signal) {
37
+ const controller = new AbortController();
38
+ const timeout = setTimeout(() => controller.abort(new Error(`Discovery timed out after ${timeoutMs}ms`)), timeoutMs);
39
+ const abort = () => controller.abort(signal?.reason);
40
+ signal?.addEventListener("abort", abort, { once: true });
41
+ return { signal: controller.signal, cleanup: () => { clearTimeout(timeout); signal?.removeEventListener("abort", abort); } };
42
+ }
43
+ export async function discover(endpoint, signal, fetcher = fetch) {
44
+ const errors = [];
45
+ for (const url of discoveryURLs(endpoint.baseURL)) {
46
+ const linked = combinedSignal(endpoint.timeoutMs ?? 10_000, signal);
47
+ try {
48
+ const response = await fetcher(url, { headers: resolveHeaders(endpoint), signal: linked.signal });
49
+ if (!response.ok)
50
+ throw new Error(`HTTP ${response.status}`);
51
+ return parseModels(await response.json());
52
+ }
53
+ catch (error) {
54
+ if (signal?.aborted)
55
+ throw error;
56
+ errors.push(`${url}: ${error instanceof Error ? error.message : String(error)}`);
57
+ }
58
+ finally {
59
+ linked.cleanup();
60
+ }
61
+ }
62
+ throw new Error(`Model discovery failed (${errors.join("; ")})`);
63
+ }
64
+ //# sourceMappingURL=discovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ export { default } from "./plugin.js";
2
+ export * from "./types.js";
3
+ export { discover, discoveryURLs, parseModels, resolveHeaders } from "./discovery.js";
4
+ export { normalizeModel, normalizeCatalogID, isImageOnly } from "./normalize.js";
5
+ export { loadWithCache, validCache } from "./cache.js";
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACrF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}
package/dist/index.js ADDED
@@ -0,0 +1,6 @@
1
+ export { default } from "./plugin.js";
2
+ export * from "./types.js";
3
+ export { discover, discoveryURLs, parseModels, resolveHeaders } from "./discovery.js";
4
+ export { normalizeModel, normalizeCatalogID, isImageOnly } from "./normalize.js";
5
+ export { loadWithCache, validCache } from "./cache.js";
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACrF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}
@@ -0,0 +1,5 @@
1
+ import type { DiscoveredModel, ModelMetadata } from "./types.js";
2
+ export declare const normalizeCatalogID: (id: string) => string;
3
+ export declare function isImageOnly(model: ModelMetadata): boolean;
4
+ export declare function normalizeModel(raw: ModelMetadata, catalog?: Record<string, ModelMetadata>): DiscoveredModel | undefined;
5
+ //# sourceMappingURL=normalize.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAKhE,eAAO,MAAM,kBAAkB,GAAI,IAAI,MAAM,WAAoE,CAAA;AAUjH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAIzD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,eAAe,GAAG,SAAS,CA2BvH"}
@@ -0,0 +1,47 @@
1
+ const own = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
2
+ const number = (...values) => values.find((v) => typeof v === "number" && Number.isSafeInteger(v) && v > 0);
3
+ const bool = (...values) => values.find((v) => typeof v === "boolean");
4
+ export const normalizeCatalogID = (id) => id.toLowerCase().replace(/^models\//, "").replace(/[_ ]/g, "-");
5
+ function catalogMatch(id, catalog) {
6
+ if (!catalog)
7
+ return undefined;
8
+ if (catalog[id])
9
+ return catalog[id];
10
+ const normalized = normalizeCatalogID(id);
11
+ const matches = Object.entries(catalog).filter(([key]) => normalizeCatalogID(key) === normalized);
12
+ return matches.length === 1 ? matches[0]?.[1] : undefined;
13
+ }
14
+ export function isImageOnly(model) {
15
+ const type = typeof model.type === "string" ? model.type.toLowerCase() : "";
16
+ const output = Array.isArray(model.output_modalities) ? model.output_modalities.map(String) : [];
17
+ return ((type === "image" || type === "image-generation") && !model.modalities?.includes("text")) || (output.length > 0 && output.includes("image") && !output.includes("text"));
18
+ }
19
+ export function normalizeModel(raw, catalog) {
20
+ const idValue = raw.id ?? raw.name;
21
+ if (typeof idValue !== "string" || !idValue || isImageOnly(raw))
22
+ return undefined;
23
+ const id = idValue;
24
+ const match = catalogMatch(id, catalog);
25
+ const endpointCaps = raw.capabilities ?? {};
26
+ const catalogCaps = match?.capabilities ?? {};
27
+ const explicitContext = number(raw.context, raw.context_length, raw.max_context_length);
28
+ const catalogContext = number(match?.context, match?.context_length, match?.max_context_length);
29
+ const explicitOutput = number(raw.output, raw.max_output_tokens);
30
+ const catalogOutput = number(match?.output, match?.max_output_tokens);
31
+ const explicitTools = bool(own(endpointCaps, "tools") ? endpointCaps.tools : undefined, own(raw, "tools") ? raw.tools : undefined, own(raw, "tool_calling") ? raw.tool_calling : undefined);
32
+ const catalogTools = bool(catalogCaps.tools, match?.tools, match?.tool_calling);
33
+ const explicitReasoning = bool(own(endpointCaps, "reasoning") ? endpointCaps.reasoning : undefined, own(raw, "reasoning") ? raw.reasoning : undefined);
34
+ const catalogReasoning = bool(catalogCaps.reasoning, match?.reasoning);
35
+ const explicitInput = Array.isArray(endpointCaps.input) ? endpointCaps.input : Array.isArray(raw.input) ? raw.input : undefined;
36
+ const catalogInput = Array.isArray(catalogCaps.input) ? catalogCaps.input : Array.isArray(match?.input) ? match.input : undefined;
37
+ const heuristicReasoning = /^(o[1-9](?:-|$)|.*\b(reasoner|reasoning)\b)/i.test(id);
38
+ const source = (explicit, catalogValue, fallback, heuristic) => explicit !== undefined ? [explicit, "endpoint"] : catalogValue !== undefined ? [catalogValue, "catalog"] : heuristic !== undefined ? [heuristic, "heuristic"] : [fallback, "default"];
39
+ const [context, contextSource] = source(explicitContext, catalogContext, 32_768);
40
+ const [discoveredOutput, outputSource] = source(explicitOutput, catalogOutput, 4_096);
41
+ const output = Math.min(discoveredOutput, context);
42
+ const [tools, toolsSource] = source(explicitTools, catalogTools, false);
43
+ const [reasoning, reasoningSource] = source(explicitReasoning, catalogReasoning, false, heuristicReasoning ? true : undefined);
44
+ const [input, inputSource] = source(explicitInput, catalogInput, ["text"]);
45
+ return { id, name: typeof raw.name === "string" ? raw.name : id, context, output, tools, reasoning, input, ...(typeof raw.type === "string" ? { type: raw.type } : {}), provenance: { context: contextSource, output: outputSource, tools: toolsSource, reasoning: reasoningSource, input: inputSource } };
46
+ }
47
+ //# sourceMappingURL=normalize.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"normalize.js","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import { Plugin } from "@opencode/plugin";
2
+ import type { PluginOptions } from "./types.js";
3
+ export declare function parsePluginOptions(value: unknown): PluginOptions;
4
+ declare const _default: Plugin.Plugin;
5
+ export default _default;
6
+ //# sourceMappingURL=plugin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAY,MAAM,kBAAkB,CAAA;AAK1D,OAAO,KAAK,EAAoC,aAAa,EAAE,MAAM,YAAY,CAAA;AAOjF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAgBhE;;AAqCD,wBA2EE"}
package/dist/plugin.js ADDED
@@ -0,0 +1,136 @@
1
+ import { Model, Plugin, Provider } from "@opencode/plugin";
2
+ import { discover } from "./discovery.js";
3
+ import { loadWithCache } from "./cache.js";
4
+ import { normalizeModel } from "./normalize.js";
5
+ const validDuration = (value, allowZero) => typeof value === "number" && Number.isFinite(value) && (allowZero ? value >= 0 : value > 0);
6
+ export function parsePluginOptions(value) {
7
+ if (!value || typeof value !== "object" || !Array.isArray(value.endpoints))
8
+ throw new Error("custom-api: options.endpoints must be an array");
9
+ const endpoints = value.endpoints;
10
+ const ids = new Set();
11
+ for (const endpoint of endpoints) {
12
+ if (!endpoint || typeof endpoint.id !== "string" || !/^[a-z0-9][a-z0-9._-]*$/i.test(endpoint.id))
13
+ throw new Error("custom-api: each endpoint needs a valid id");
14
+ if (ids.has(endpoint.id))
15
+ throw new Error(`custom-api: duplicate endpoint id ${endpoint.id}`);
16
+ ids.add(endpoint.id);
17
+ if (typeof endpoint.baseURL !== "string" || !/^https?:\/\//.test(endpoint.baseURL))
18
+ throw new Error(`custom-api: ${endpoint.id}.baseURL must be an HTTP(S) URL`);
19
+ if (endpoint.protocol !== "openai-compatible" && endpoint.protocol !== "anthropic-compatible")
20
+ throw new Error(`custom-api: ${endpoint.id}.protocol is invalid`);
21
+ if (endpoint.apiKey && (typeof endpoint.apiKey.env !== "string" || !endpoint.apiKey.env))
22
+ throw new Error(`custom-api: ${endpoint.id}.apiKey must be { env: "NAME" }`);
23
+ if (endpoint.timeoutMs !== undefined && !validDuration(endpoint.timeoutMs, false))
24
+ throw new Error(`custom-api: ${endpoint.id}.timeoutMs must be finite and positive`);
25
+ if (endpoint.cacheTtlMs !== undefined && !validDuration(endpoint.cacheTtlMs, true))
26
+ throw new Error(`custom-api: ${endpoint.id}.cacheTtlMs must be finite and nonnegative`);
27
+ if (endpoint.refreshIntervalMs !== undefined && !validDuration(endpoint.refreshIntervalMs, true))
28
+ throw new Error(`custom-api: ${endpoint.id}.refreshIntervalMs must be finite and nonnegative`);
29
+ }
30
+ return { endpoints };
31
+ }
32
+ function runtimeHeaders(endpoint) {
33
+ const headers = {};
34
+ if (endpoint.apiKey) {
35
+ const key = process.env[endpoint.apiKey.env];
36
+ if (key)
37
+ endpoint.protocol === "anthropic-compatible" ? headers["x-api-key"] = key : headers.Authorization = `Bearer ${key}`;
38
+ }
39
+ for (const [name, reference] of Object.entries(endpoint.headers ?? {})) {
40
+ const value = typeof reference === "string" ? reference : process.env[reference.env];
41
+ if (value !== undefined)
42
+ headers[name] = value;
43
+ }
44
+ return headers;
45
+ }
46
+ function toModel(providerID, value) {
47
+ return {
48
+ ...Model.Info.default(providerID, Model.ID.make(value.id)),
49
+ name: value.name,
50
+ type: value.type,
51
+ limit: { context: value.context, output: value.output },
52
+ capabilities: { tools: value.tools, input: value.input, output: ["text"] },
53
+ compatibility: value.reasoning ? { requireReasoning: true } : undefined,
54
+ };
55
+ }
56
+ async function readSource(ctx, endpoint, force = false, signal) {
57
+ const load = async () => (await discover(endpoint, signal)).map(raw => normalizeModel(raw, endpoint.catalog)).filter((item) => item !== undefined);
58
+ const cache = await loadWithCache({ get: key => ctx.storage.get(key), set: (key, value) => ctx.storage.set(key, value) }, `inventory/v1/${endpoint.id}`, force ? 0 : endpoint.cacheTtlMs ?? 300_000, load);
59
+ return { endpoint, ...cache };
60
+ }
61
+ export default Plugin.define({
62
+ id: "custom-api",
63
+ async setup(ctx) {
64
+ const config = parsePluginOptions(ctx.options);
65
+ const controllers = new Set();
66
+ const sources = [];
67
+ for (const endpoint of config.endpoints)
68
+ sources.push(await readSource(ctx, endpoint));
69
+ const providerRegistration = await ctx.provider.transform(editor => {
70
+ for (const source of sources) {
71
+ const endpoint = source.endpoint;
72
+ const id = Provider.ID.make(endpoint.id);
73
+ editor.add({
74
+ info: {
75
+ ...Provider.Info.empty(id),
76
+ name: endpoint.name ?? endpoint.id,
77
+ activation: "enabled",
78
+ package: endpoint.protocol === "anthropic-compatible" ? "@opencode/ai/providers/anthropic-compatible" : "@opencode/ai/providers/openai-compatible",
79
+ settings: { baseURL: endpoint.baseURL, timeout: endpoint.timeoutMs ?? 10_000 },
80
+ headers: runtimeHeaders(endpoint),
81
+ },
82
+ models: source.models.map(model => toModel(id, model)),
83
+ });
84
+ }
85
+ });
86
+ // V2 has no `capabilities.reasoning` field. Preserve discovered reasoning through
87
+ // the official compatibility flag in a model transform.
88
+ const modelRegistration = await ctx.model.transform(editor => {
89
+ for (const source of sources)
90
+ for (const model of source.models) {
91
+ if (!model.reasoning)
92
+ continue;
93
+ editor.update(source.endpoint.id, model.id, draft => { draft.compatibility = { ...draft.compatibility, requireReasoning: true }; });
94
+ }
95
+ });
96
+ const refresh = async (only, signal) => {
97
+ const selected = sources.filter(source => !only || source.endpoint.id === only);
98
+ if (only && selected.length === 0)
99
+ throw new Error(`Unknown endpoint: ${only}`);
100
+ await Promise.all(selected.map(async (source) => {
101
+ const next = await readSource(ctx, source.endpoint, true, signal);
102
+ source.models = next.models;
103
+ source.stale = next.stale;
104
+ }));
105
+ await ctx.provider.reload();
106
+ await ctx.model.reload();
107
+ return selected.map(source => ({ endpoint: source.endpoint.id, models: source.models.length, stale: source.stale }));
108
+ };
109
+ const toolRegistration = await ctx.tool.transform(editor => {
110
+ editor.namespace({ name: "custom_api", description: "Custom API endpoint inventory management" });
111
+ editor.add({
112
+ name: "refresh",
113
+ description: "Refresh custom endpoint model inventories. Optionally restrict to one endpoint ID.",
114
+ input: { type: "object", properties: { endpoint: { type: "string" } }, additionalProperties: false },
115
+ options: { namespace: "custom_api", codemode: false },
116
+ execute: async (input, context) => ({ content: JSON.stringify(await refresh(input.endpoint, context.signal)) }),
117
+ });
118
+ });
119
+ const commandRegistration = await ctx.command.transform(editor => editor.add({
120
+ name: "custom-api-refresh",
121
+ description: "Refresh every custom API model inventory",
122
+ execute: async () => { await refresh(); },
123
+ }));
124
+ const timers = sources.flatMap(source => source.endpoint.refreshIntervalMs && source.endpoint.refreshIntervalMs > 0 ? [setInterval(() => {
125
+ const controller = new AbortController();
126
+ controllers.add(controller);
127
+ void refresh(source.endpoint.id, controller.signal).catch(console.error).finally(() => controllers.delete(controller));
128
+ }, source.endpoint.refreshIntervalMs)] : []);
129
+ return async () => {
130
+ timers.forEach(clearInterval);
131
+ controllers.forEach(controller => controller.abort());
132
+ await Promise.all([providerRegistration.dispose(), modelRegistration.dispose(), toolRegistration.dispose(), commandRegistration.dispose()]);
133
+ };
134
+ },
135
+ });
136
+ //# sourceMappingURL=plugin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,59 @@
1
+ export type Protocol = "openai-compatible" | "anthropic-compatible";
2
+ export interface EnvReference {
3
+ env: string;
4
+ }
5
+ export interface CapabilityMetadata {
6
+ input?: string[];
7
+ tools?: boolean;
8
+ reasoning?: boolean;
9
+ }
10
+ export interface ModelMetadata {
11
+ id?: string;
12
+ name?: string;
13
+ context?: number;
14
+ context_length?: number;
15
+ max_context_length?: number;
16
+ output?: number;
17
+ max_output_tokens?: number;
18
+ capabilities?: CapabilityMetadata;
19
+ input?: string[];
20
+ tools?: boolean;
21
+ tool_calling?: boolean;
22
+ reasoning?: boolean;
23
+ type?: string;
24
+ modalities?: string[];
25
+ output_modalities?: string[];
26
+ [key: string]: unknown;
27
+ }
28
+ export interface EndpointOptions {
29
+ id: string;
30
+ name?: string;
31
+ baseURL: string;
32
+ protocol: Protocol;
33
+ apiKey?: EnvReference;
34
+ headers?: Record<string, string | EnvReference>;
35
+ timeoutMs?: number;
36
+ cacheTtlMs?: number;
37
+ refreshIntervalMs?: number;
38
+ catalog?: Record<string, ModelMetadata>;
39
+ }
40
+ export interface PluginOptions {
41
+ endpoints: EndpointOptions[];
42
+ }
43
+ export interface DiscoveredModel {
44
+ id: string;
45
+ name: string;
46
+ context: number;
47
+ output: number;
48
+ input: string[];
49
+ tools: boolean;
50
+ reasoning: boolean;
51
+ type?: string;
52
+ provenance: Record<string, "endpoint" | "catalog" | "heuristic" | "default">;
53
+ }
54
+ export interface CacheEntry {
55
+ version: 1;
56
+ savedAt: number;
57
+ models: DiscoveredModel[];
58
+ }
59
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,mBAAmB,GAAG,sBAAsB,CAAA;AAEnE,MAAM,WAAW,YAAY;IAAG,GAAG,EAAE,MAAM,CAAA;CAAE;AAC7C,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AACD,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,YAAY,CAAC,EAAE,kBAAkB,CAAA;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AACD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,CAAA;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CACxC;AACD,MAAM,WAAW,aAAa;IAAG,SAAS,EAAE,eAAe,EAAE,CAAA;CAAE;AAC/D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC,CAAA;CAC7E;AACD,MAAM,WAAW,UAAU;IAAG,OAAO,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE"}
package/dist/types.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
package/package.json CHANGED
@@ -1,6 +1,21 @@
1
1
  {
2
2
  "name": "opencode-custom-api",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.0",
4
+ "description": "Discover custom OpenAI- and Anthropic-compatible model endpoints in OpenCode V2",
5
+ "type": "module",
6
+ "license": "MIT",
7
+ "author": "OpenCode community",
8
+ "keywords": ["opencode", "plugin", "openai", "anthropic", "models"],
9
+ "repository": { "type": "git", "url": "https://github.com/6zev/opencode-custom-api.git" },
10
+ "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
11
+ "files": ["dist", "README.md", "LICENSE"],
12
+ "scripts": {
13
+ "build": "tsc -p tsconfig.build.json",
14
+ "typecheck": "tsc -p tsconfig.json --noEmit",
15
+ "test": "vitest run",
16
+ "prepublishOnly": "npm run test && npm run typecheck && npm run build"
17
+ },
18
+ "engines": { "node": ">=20" },
19
+ "dependencies": { "@opencode/plugin": "^2.3.2" },
20
+ "devDependencies": { "@types/node": "^24.10.1", "typescript": "^5.9.3", "vitest": "^4.0.14" }
21
+ }