@@ -0,0 +1,20 @@
+# OpenCode local tools
+
+This directory contains project-local OpenCode configuration and tools. Its
+installed SDK dependency is `@opencode-ai/plugin` 1.18.3. The GitHub tools use
+the legacy tool helper exported by `@opencode-ai/plugin/tool`.
+
+The monorepo's workspace package `@opencode/plugin` is a different SDK surface
+and does not provide this `tool` export. Keep these project tools bound to the
+installed SDK import; changing it to the workspace package prevents OpenCode
+from loading the tools.
+
+Run the offline tool contract regression checks from this directory with:
+
+```sh
+bun test ./test/tool-sdk.test.ts
+```
+
+The checks load both tools, validate their argument schemas and defaults, and
+convert the schemas to JSON Schema. They do not call the tools' `execute`
+functions or contact GitHub.
@@ -0,0 +1,50 @@
+import { expect, test } from "bun:test"
+import { tool } from "@opencode-ai/plugin/tool"
+import githubPrSearch from "../tool/github-pr-search.ts"
+import githubTriage from "../tool/github-triage.ts"
+
+test("GitHub tools load with the installed OpenCode tool SDK", () => {
+  expect(githubPrSearch.description).toContain("search GitHub pull requests")
+  expect(githubPrSearch.args.query).toBeInstanceOf(tool.schema.ZodString)
+  expect(githubPrSearch.execute).toBeFunction()
+
+  expect(githubTriage.description).toContain("assign a GitHub issue")
+  expect(githubTriage.args.team).toBeInstanceOf(tool.schema.ZodEnum)
+  expect(githubTriage.execute).toBeFunction()
+})
+
+test("GitHub triage arguments validate and convert to JSON Schema", () => {
+  const schema = tool.schema.object(githubTriage.args)
+  expect(schema.parse({ team: "core" })).toEqual({ team: "core" })
+  expect(schema.safeParse({ team: "not-a-team" }).success).toBe(false)
+
+  expect(tool.schema.toJSONSchema(schema, { io: "input" })).toMatchObject({
+    type: "object",
+    properties: {
+      team: { enum: ["tui", "desktop_web", "core", "inference", "windows"] },
+    },
+    required: ["team"],
+  })
+})
+
+test("GitHub PR search arguments validate defaults and convert to JSON Schema", () => {
+  const schema = tool.schema.object(githubPrSearch.args)
+  expect(schema.parse({ query: "quota" })).toEqual({ query: "quota", limit: 10, offset: 0 })
+  expect(schema.parse({ query: "quota", limit: 5, offset: 10 })).toEqual({
+    query: "quota",
+    limit: 5,
+    offset: 10,
+  })
+  expect(schema.safeParse({ query: 7 }).success).toBe(false)
+  expect(schema.safeParse({ query: "quota", limit: "10" }).success).toBe(false)
+
+  expect(tool.schema.toJSONSchema(schema, { io: "input" })).toMatchObject({
+    type: "object",
+    properties: {
+      query: { type: "string" },
+      limit: { type: "number", default: 10 },
+      offset: { type: "number", default: 0 },
+    },
+    required: ["query"],
+  })
+})
@@ -1,5 +1,5 @@
 /// <reference path="../env.d.ts" />
-import { tool } from "@opencode/plugin"
+import { tool } from "@opencode-ai/plugin/tool"
 async function githubFetch(endpoint: string, options: RequestInit = {}) {
   const response = await fetch(`https://api.github.com${endpoint}`, {
     ...options,