opencodekit 0.15.11 → 0.15.13

package/dist/template/.opencode/plans/1768385996691-silent-wizard.md

@@ -38,7 +38,16 @@ If memory returns high-confidence findings on this exact topic, synthesize and r
 | Priority | Tool | Use Case | Speed |
 |----------|------|----------|-------|
 | 1 | memory-search | Past research findings | Instant |
-| 2 | context7 | Official library docs | Fast |
+| Priority | Tool | Use Case | Speed |
+|----------|------|----------|-------|
+| 1 | memory-search | Past research findings | Instant |
+| 2 | context7_resolve-library-id | Resolve library names to IDs | Fast |
+| 3 | context7_query-docs | Official library docs | Fast |
+| 4 | codesearch | Exa Code API for SDK/library patterns | Fast |
+| 5 | grep-search | Cross-repo GitHub code search | Medium |
+| 6 | webfetch | Specific doc URLs, READMEs, changelogs | Medium |
+| 7 | opensrc + LSP | Clone & analyze source code | Slow |
+| 8 | websearch | Tutorials, blog posts, recent news | Slow |
 | 3 | codesearch | Usage patterns in real code | Fast |
 | 4 | gh_grep | Cross-repo deep code search | Medium |
 | 5 | webfetch | Specific doc URLs, READMEs, changelogs | Medium |
@@ -76,7 +85,8 @@ webfetch({ url: "https://docs.example.com/api/authentication", format: "markdown
 **When to use:**
 
 - User provides a specific URL
-- context7 returns a doc link worth fetching
+- context7_resolve-library-id returns a library ID
+- context7_query-docs returns a doc link worth fetching
 - Need CHANGELOG or release notes
 - GitHub README has details not in context7
 

package/dist/template/.opencode/plugin/copilot-auth.ts

@@ -5,7 +5,11 @@
 
 import type { Plugin } from "@opencode-ai/plugin";
 
-const CLIENT_ID = "Iv1.b507a08c87ecfe98";
+const CLIENT_ID = "Ov23li8tweQw6odWQebz";
+
+// Add a small safety buffer when polling to avoid hitting the server
+// slightly too early due to clock skew / timer drift.
+const OAUTH_POLLING_SAFETY_MARGIN_MS = 3000; // 3 seconds
 
 const HEADERS = {
 	"User-Agent": "GitHubCopilotChat/0.35.0",
@@ -40,11 +44,12 @@ function getUrls(domain: string) {
 	return {
 		DEVICE_CODE_URL: `https://${domain}/login/device/code`,
 		ACCESS_TOKEN_URL: `https://${domain}/login/oauth/access_token`,
-		COPILOT_API_KEY_URL: `https://api.github.com/copilot_internal/v2/token`,
 	};
 }
 
-export const CopilotAuthPlugin: Plugin = async ({ client }) => {
+const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
+
+export const CopilotAuthPlugin: Plugin = async ({ client: _client }) => {
 	return {
 		auth: {
 			provider: "github-copilot",
@@ -52,6 +57,11 @@ export const CopilotAuthPlugin: Plugin = async ({ client }) => {
 				const info = await getAuth();
 				if (!info || info.type !== "oauth") return {};
 
+				const enterpriseUrl = info.enterpriseUrl;
+				const baseURL = enterpriseUrl
+					? `https://copilot-api.${normalizeDomain(enterpriseUrl)}`
+					: undefined;
+
 				if (provider && provider.models) {
 					for (const model of Object.values(provider.models)) {
 						model.cost = {
@@ -62,71 +72,47 @@ export const CopilotAuthPlugin: Plugin = async ({ client }) => {
 								write: 0,
 							},
 						};
+
+						// Sync with official: Handle Claude routing and SDK mapping
+						const base =
+							baseURL ?? model.api.url ?? "https://api.githubcopilot.com";
+						const isClaude = model.id.includes("claude");
+
+						let url = base;
+						if (isClaude) {
+							if (!url.endsWith("/v1")) {
+								url = url.endsWith("/") ? `${url}v1` : `${url}/v1`;
+							}
+						}
+
+						model.api.url = url;
+						model.api.npm = isClaude
+							? "@ai-sdk/anthropic"
+							: "@ai-sdk/github-copilot";
 					}
 				}
 
-				const enterpriseUrl = info.enterpriseUrl;
-				const baseURL = enterpriseUrl
-					? `https://copilot-api.${normalizeDomain(enterpriseUrl)}`
-					: "https://api.githubcopilot.com";
-
 				return {
-					baseURL,
 					apiKey: "",
 					async fetch(input, init) {
 						const info = await getAuth();
-						if (info.type !== "oauth") return {};
-						if (!info.access) {
-							const domain = info.enterpriseUrl
-								? normalizeDomain(info.enterpriseUrl)
-								: "github.com";
-							const urls = getUrls(domain);
-
-							const response = await fetch(urls.COPILOT_API_KEY_URL, {
-								headers: {
-									Accept: "application/json",
-									Authorization: `Bearer ${info.refresh}`,
-									...HEADERS,
-								},
-							});
-
-							if (!response.ok) {
-								throw new Error(`Token refresh failed: ${response.status}`);
-							}
-
-							const tokenData = await response.json();
-
-							const saveProviderID = info.enterpriseUrl
-								? "github-copilot-enterprise"
-								: "github-copilot";
-							await client.auth.set({
-								path: {
-									id: saveProviderID,
-								},
-								body: {
-									type: "oauth",
-									refresh: info.refresh,
-									access: tokenData.token,
-									expires: tokenData.expires_at * 1000 - 5 * 60 * 1000,
-									...(info.enterpriseUrl && {
-										enterpriseUrl: info.enterpriseUrl,
-									}),
-								},
-							});
-							info.access = tokenData.token;
-						}
+						if (info.type !== "oauth") return fetch(input, init);
 
 						let isAgentCall = false;
 						let isVisionRequest = false;
 						try {
 							const body =
-								typeof init.body === "string"
+								typeof init?.body === "string"
 									? JSON.parse(init.body)
-									: init.body;
-							if (body?.messages) {
-								isAgentCall = body.messages.some(
-									(msg: any) =>
-										msg.role && ["tool", "assistant"].includes(msg.role),
+									: init?.body;
+
+							const url = input.toString();
+
+							// Completions API
+							if (body?.messages && url.includes("completions")) {
+								// Keep local logic: detect if any message is assistant/tool
+								isAgentCall = body.messages.some((msg: any) =>
+									["tool", "assistant"].includes(msg.role),
 								);
 								isVisionRequest = body.messages.some(
 									(msg: any) =>
@@ -135,34 +121,58 @@ export const CopilotAuthPlugin: Plugin = async ({ client }) => {
 								);
 							}
 
+							// Responses API
 							if (body?.input) {
-								const lastInput = body.input[body.input.length - 1];
-
-								const isAssistant = lastInput?.role === "assistant";
-								const hasAgentType = lastInput?.type
-									? RESPONSES_API_ALTERNATE_INPUT_TYPES.includes(lastInput.type)
-									: false;
-								isAgentCall = isAssistant || hasAgentType;
-
-								isVisionRequest =
-									Array.isArray(lastInput?.content) &&
-									lastInput.content.some(
-										(part: any) => part.type === "input_image",
-									);
+								isAgentCall = body.input.some(
+									(item: any) =>
+										item?.role === "assistant" ||
+										(item?.type &&
+											RESPONSES_API_ALTERNATE_INPUT_TYPES.includes(item.type)),
+								);
+
+								isVisionRequest = body.input.some(
+									(item: any) =>
+										Array.isArray(item?.content) &&
+										item.content.some(
+											(part: any) => part.type === "input_image",
+										),
+								);
+							}
+
+							// Messages API (Anthropic style)
+							if (body?.messages && !url.includes("completions")) {
+								isAgentCall = body.messages.some((msg: any) =>
+									["tool", "assistant"].includes(msg.role),
+								);
+								isVisionRequest = body.messages.some(
+									(item: any) =>
+										Array.isArray(item?.content) &&
+										item.content.some(
+											(part: any) =>
+												part?.type === "image" ||
+												(part?.type === "tool_result" &&
+													Array.isArray(part?.content) &&
+													part.content.some(
+														(nested: any) => nested?.type === "image",
+													)),
+										),
+								);
 							}
 						} catch {}
 
-						const headers = {
-							...init.headers,
+						const headers: Record<string, string> = {
+							"x-initiator": isAgentCall ? "agent" : "user",
+							...(init?.headers as Record<string, string>),
 							...HEADERS,
-							Authorization: `Bearer ${info.access}`,
+							Authorization: `Bearer ${info.refresh}`,
 							"Openai-Intent": "conversation-edits",
-							"X-Initiator": isAgentCall ? "agent" : "user",
 						};
+
 						if (isVisionRequest) {
 							headers["Copilot-Vision-Request"] = "true";
 						}
 
+						// Official only deletes lowercase "authorization"
 						delete headers["x-api-key"];
 						delete headers["authorization"];
 
@@ -286,7 +296,7 @@ export const CopilotAuthPlugin: Plugin = async ({ client }) => {
 										} = {
 											type: "success",
 											refresh: data.access_token,
-											access: "",
+											access: data.access_token,
 											expires: 0,
 										};
 
@@ -299,16 +309,33 @@ export const CopilotAuthPlugin: Plugin = async ({ client }) => {
 									}
 
 									if (data.error === "authorization_pending") {
-										await new Promise((resolve) =>
-											setTimeout(resolve, deviceData.interval * 1000),
+										await sleep(
+											deviceData.interval * 1000 +
+												OAUTH_POLLING_SAFETY_MARGIN_MS,
 										);
 										continue;
 									}
 
+									if (data.error === "slow_down") {
+										// Based on the RFC spec, we must add 5 seconds to our current polling interval.
+										let newInterval = (deviceData.interval + 5) * 1000;
+
+										if (
+											data.interval &&
+											typeof data.interval === "number" &&
+											data.interval > 0
+										) {
+											newInterval = data.interval * 1000;
+										}
+
+										await sleep(newInterval + OAUTH_POLLING_SAFETY_MARGIN_MS);
+										continue;
+									}
+
 									if (data.error) return { type: "failed" };
 
-									await new Promise((resolve) =>
-										setTimeout(resolve, deviceData.interval * 1000),
+									await sleep(
+										deviceData.interval * 1000 + OAUTH_POLLING_SAFETY_MARGIN_MS,
 									);
 									continue;
 								}

package/dist/template/.opencode/skill/source-code-research/SKILL.md

@@ -362,20 +362,20 @@ If opensrc doesn't work:
 
 Source code research complements other tools:
 
-| Method         | Best For                   | Source Code Adds               |
-| -------------- | -------------------------- | ------------------------------ |
-| **Context7**   | API docs, official guides  | Implementation details         |
-| **codesearch** | Usage patterns in the wild | Canonical implementation       |
-| **gh_grep**    | Real-world examples        | How library itself works       |
-| **Web search** | Tutorials, blog posts      | Ground truth from source       |
-| **Codebase**   | Project-specific patterns  | How dependencies actually work |
+| Method          | Best For                   | Source Code Adds               |
+| --------------- | -------------------------- | ------------------------------ |
+| **Context7**    | API docs, official guides  | Implementation details         |
+| **codesearch**  | Usage patterns in the wild | Canonical implementation       |
+| **grep_search** | Real-world examples        | How library itself works       |
+| **Web search**  | Tutorials, blog posts      | Ground truth from source       |
+| **Codebase**    | Project-specific patterns  | How dependencies actually work |
 
 **Recommended flow:**
 
 1. Context7 - Check official docs
 2. Codebase - Check existing usage
 3. **Source code** - If still unclear, fetch source
-4. codesearch/gh_grep - See how others use it
+4. codesearch/grep_search - See how others use it
 5. Web search - Last resort for context
 
 ## Cleanup

package/dist/template/.opencode/skill/tool-priority/SKILL.md

@@ -180,9 +180,11 @@ glob ["src/**/*.ts", "tests/**/*.ts"]
 
 ## Research Tools
 
-| Tool           | Use When                                                |
-| -------------- | ------------------------------------------------------- |
-| **context7**   | Library docs (try first). Fast, external APIs.          |
-| **websearch**  | Docs not in Context7, recent releases, troubleshooting. |
-| **codesearch** | Real implementation patterns from GitHub.               |
-| **webfetch**   | Specific URL user provided.                             |
+| Tool                            | Use When                                                |
+| ------------------------------- | ------------------------------------------------------- |
+| **context7_resolve-library-id** | Resolve library names to IDs (try first).               |
+| **context7_query-docs**         | Query official library documentation. Fast.             |
+| **websearch**                   | Docs not in Context7, recent releases, troubleshooting. |
+| **codesearch**                  | Real implementation patterns from GitHub.               |
+| **grep-search**                 | Cross-repo code patterns via grep.app.                  |
+| **webfetch**                    | Specific URL user provided.                             |

package/dist/template/.opencode/tool/context7-query-docs.ts

@@ -0,0 +1,89 @@
+import { tool } from "@opencode-ai/plugin";
+
+// Context7 API v2 - https://context7.com/docs/api-guide
+const CONTEXT7_API = "https://context7.com/api/v2";
+
+export default tool({
+	description: `Query library documentation from Context7 using a library ID.
+
+Use when:
+- You have a library ID (from context7_resolve_library_id)
+- Need specific documentation about a library feature
+- Looking for API reference, examples, or setup instructions
+
+Always resolve library name to ID first with context7_resolve_library_id!
+
+Examples:
+  context7_query_docs({ libraryId: "/reactjs/react.dev", topic: "hooks" })
+  context7_query_docs({ libraryId: "/vercel/next.js", topic: "middleware" })
+  context7_query_docs({ libraryId: "/microsoft/TypeScript", topic: "generics" })
+`,
+	args: {
+		libraryId: tool.schema
+			.string()
+			.describe(
+				"Library ID from context7_resolve_library_id (e.g., '/reactjs/react.dev')",
+			),
+		topic: tool.schema
+			.string()
+			.describe("Documentation topic or feature to search for"),
+	},
+	execute: async (args) => {
+		const { libraryId, topic } = args;
+
+		if (!libraryId || libraryId.trim() === "") {
+			return "Error: libraryId is required (use context7-resolve-library-id first)";
+		}
+
+		if (!topic || topic.trim() === "") {
+			return "Error: topic is required (e.g., 'hooks', 'setup', 'API reference')";
+		}
+
+		try {
+			// Query Context7 documentation - GET /api/v2/context
+			// Returns text format by default which is better for LLM consumption
+			const url = new URL(`${CONTEXT7_API}/context`);
+			url.searchParams.set("libraryId", libraryId);
+			url.searchParams.set("query", topic);
+
+			// Add API key if available (recommended for higher rate limits)
+			const apiKey = process.env.CONTEXT7_API_KEY;
+			const headers: HeadersInit = {
+				Accept: "text/plain",
+				"User-Agent": "OpenCode/1.0",
+			};
+
+			if (apiKey) {
+				headers.Authorization = `Bearer ${apiKey}`;
+			}
+
+			const response = await fetch(url.toString(), { headers });
+
+			if (!response.ok) {
+				if (response.status === 401) {
+					return `Error: Invalid CONTEXT7_API_KEY. Get a free key at https://context7.com/dashboard`;
+				}
+				if (response.status === 404) {
+					return `Error: Library not found: ${libraryId}\n\nUse context7-resolve-library-id first to find the correct ID.`;
+				}
+				if (response.status === 429) {
+					return `Error: Rate limit exceeded. Get a free API key at https://context7.com/dashboard for higher limits.`;
+				}
+				return `Error: Context7 API returned ${response.status}`;
+			}
+
+			const content = await response.text();
+
+			if (!content || content.trim() === "") {
+				return `No documentation found for "${topic}" in ${libraryId}.\n\nTry:\n- Simpler terms (e.g., "useState" instead of "state management")\n- Different topic spelling\n- Broader topics like "API reference" or "getting started"`;
+			}
+
+			return `# Documentation: ${topic} (${libraryId})
+
+${content}`;
+		} catch (error: unknown) {
+			const message = error instanceof Error ? error.message : String(error);
+			return `Error querying documentation: ${message}`;
+		}
+	},
+});

package/dist/template/.opencode/tool/context7-resolve-library-id.ts

@@ -0,0 +1,113 @@
+import { tool } from "@opencode-ai/plugin";
+
+// Context7 API v2 - https://context7.com/docs/api-guide
+const CONTEXT7_API = "https://context7.com/api/v2";
+
+interface LibraryInfo {
+	id: string;
+	title: string;
+	description?: string;
+	totalSnippets?: number;
+	trustScore?: number;
+	benchmarkScore?: number;
+	versions?: string[];
+}
+
+interface SearchResponse {
+	results: LibraryInfo[];
+}
+
+export default tool({
+	description: `Resolve a library name to its Context7 ID for documentation lookup.
+
+Use when:
+- You need to find the exact library ID format for a package
+- Starting a documentation search (get the ID first, then query docs)
+- Normalizing library names (e.g., "react" → "/reactjs/react.dev")
+
+Examples:
+  context7_resolve_library_id({ libraryName: "react" })
+  context7_resolve_library_id({ libraryName: "vue", query: "composition API" })
+  context7_resolve_library_id({ libraryName: "nextjs" })
+`,
+	args: {
+		libraryName: tool.schema
+			.string()
+			.describe(
+				"Library name to resolve (e.g., 'react', 'lodash', 'typescript')",
+			),
+		query: tool.schema
+			.string()
+			.optional()
+			.describe("Optional context for the search (improves relevance ranking)"),
+	},
+	execute: async (args) => {
+		const { libraryName, query = "documentation" } = args;
+
+		if (!libraryName || libraryName.trim() === "") {
+			return "Error: libraryName is required";
+		}
+
+		try {
+			// Query Context7 library search - GET /api/v2/libs/search
+			const url = new URL(`${CONTEXT7_API}/libs/search`);
+			url.searchParams.set("libraryName", libraryName);
+			url.searchParams.set("query", query);
+
+			// Add API key if available (recommended for higher rate limits)
+			const apiKey = process.env.CONTEXT7_API_KEY;
+			const headers: HeadersInit = {
+				Accept: "application/json",
+				"User-Agent": "OpenCode/1.0",
+			};
+
+			if (apiKey) {
+				headers.Authorization = `Bearer ${apiKey}`;
+			}
+
+			const response = await fetch(url.toString(), { headers });
+
+			if (!response.ok) {
+				if (response.status === 401) {
+					return `Error: Invalid CONTEXT7_API_KEY. Get a free key at https://context7.com/dashboard`;
+				}
+				if (response.status === 429) {
+					return `Error: Rate limit exceeded. Get a free API key at https://context7.com/dashboard for higher limits.`;
+				}
+				return `Error: Context7 API returned ${response.status}`;
+			}
+
+			const data = (await response.json()) as SearchResponse;
+			const libraries = data.results || [];
+
+			if (!libraries || libraries.length === 0) {
+				return `No libraries found matching: ${libraryName}\n\nTry:\n- Different library name\n- Check spelling\n- Use official package name`;
+			}
+
+			const formatted = libraries
+				.slice(0, 5)
+				.map((lib, i) => {
+					const desc = lib.description
+						? `\n   ${lib.description.slice(0, 100)}...`
+						: "";
+					const snippets = lib.totalSnippets
+						? ` (${lib.totalSnippets} snippets)`
+						: "";
+					const score = lib.benchmarkScore
+						? ` [score: ${lib.benchmarkScore}]`
+						: "";
+					return `${i + 1}. **${lib.title}** → \`${lib.id}\`${snippets}${score}${desc}`;
+				})
+				.join("\n\n");
+
+			return `Found ${libraries.length} libraries matching "${libraryName}":
+
+${formatted}
+
+**Next step**: Use \`context7-query-docs({ libraryId: "${libraries[0].id}", topic: "your topic" })\` to fetch documentation.`;
+		} catch (error: unknown) {
+			const message = error instanceof Error ? error.message : String(error);
+			return `Error resolving library: ${message}`;
+		}
+	},
+});

package/dist/template/.opencode/tool/grep-search.ts

@@ -0,0 +1,135 @@
+import { tool } from "@opencode-ai/plugin";
+
+const GREP_APP_API = "https://grep.app/api/search";
+
+interface SearchResult {
+	repo: string;
+	path: string;
+	content: { snippet: string };
+	total_matches: string;
+}
+
+interface GrepResponse {
+	hits: { hits: SearchResult[] };
+	time: number;
+}
+
+export default tool({
+	description: `Search real-world code examples from GitHub repositories via grep.app.
+
+Use when:
+- Implementing unfamiliar APIs - see how others use a library
+- Looking for production patterns - find real-world examples
+- Understanding library integrations - see how things work together
+
+IMPORTANT: Search for **literal code patterns**, not keywords:
+✅ Good: "useState(", "import React from", "async function"
+❌ Bad: "react tutorial", "best practices", "how to use"
+
+Examples:
+  grep_search({ query: "getServerSession", language: "TypeScript" })
+  grep_search({ query: "CORS(", language: "Python", repo: "flask" })
+  grep_search({ query: "export async function POST", path: "route.ts" })
+`,
+	args: {
+		query: tool.schema
+			.string()
+			.describe("Code pattern to search for (literal text)"),
+		language: tool.schema
+			.string()
+			.optional()
+			.describe("Filter by language: TypeScript, TSX, Python, Go, Rust, etc."),
+		repo: tool.schema
+			.string()
+			.optional()
+			.describe("Filter by repo: 'owner/repo' or partial match"),
+		path: tool.schema
+			.string()
+			.optional()
+			.describe("Filter by file path: 'src/', '.test.ts', etc."),
+		limit: tool.schema
+			.number()
+			.optional()
+			.describe("Max results to return (default: 10, max: 20)"),
+	},
+	execute: async (args) => {
+		const { query, language, repo, path, limit = 10 } = args;
+
+		if (!query || query.trim() === "") {
+			return "Error: query is required";
+		}
+
+		// Build URL with proper filter parameters
+		// grep.app uses filter[lang][0]=TypeScript format, NOT inline lang:TypeScript
+		const url = new URL(GREP_APP_API);
+		url.searchParams.set("q", query);
+
+		// Add language filter (grep.app uses filter[lang][0] format)
+		if (language) {
+			url.searchParams.set("filter[lang][0]", language);
+		}
+
+		// Add repo filter
+		if (repo) {
+			url.searchParams.set("filter[repo][0]", repo);
+		}
+
+		// Add path filter
+		if (path) {
+			url.searchParams.set("filter[path][0]", path);
+		}
+
+		try {
+			const response = await fetch(url.toString(), {
+				headers: {
+					Accept: "application/json",
+					"User-Agent": "OpenCode/1.0",
+				},
+			});
+
+			if (!response.ok) {
+				return `Error: grep.app API returned ${response.status}`;
+			}
+
+			const data = (await response.json()) as GrepResponse;
+
+			if (!data.hits?.hits?.length) {
+				return `No results found for: ${query}${language ? ` (${language})` : ""}`;
+			}
+
+			const maxResults = Math.min(limit, 20);
+			const results = data.hits.hits.slice(0, maxResults);
+
+			const formatted = results.map((hit, i) => {
+				const repoName = hit.repo || "unknown";
+				const filePath = hit.path || "unknown";
+				const snippet = hit.content?.snippet || "";
+
+				// Clean up HTML from snippet and extract text
+				const cleanCode = snippet
+					.replace(/<[^>]*>/g, "") // Remove HTML tags
+					.replace(/&lt;/g, "<")
+					.replace(/&gt;/g, ">")
+					.replace(/&amp;/g, "&")
+					.replace(/&quot;/g, '"')
+					.split("\n")
+					.slice(0, 8)
+					.join("\n")
+					.trim();
+
+				return `## ${i + 1}. ${repoName}
+**File**: ${filePath}
+\`\`\`
+${cleanCode}
+\`\`\``;
+			});
+
+			return `Found ${data.hits.hits.length} results (showing ${results.length}) in ${data.time}ms:
+
+${formatted.join("\n\n")}`;
+		} catch (error: unknown) {
+			const message = error instanceof Error ? error.message : String(error);
+			return `Error searching grep.app: ${message}`;
+		}
+	},
+});

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.15.11",
+	"version": "0.15.13",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"keywords": ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
 	"license": "MIT",