@tokensize/opencode 0.3.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TokenSize
+
+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,21 @@
+# `@tokensize/opencode`
+
+OpenCode plugin for TokenSize. It adds explicit `tokensize_status`, `tokensize_connect`, `tokensize_route`, `tokensize_execute`, and `tokensize_feedback` tools backed by the canonical `@tokensize/agent-client`.
+
+Add the exact release to `opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@tokensize/opencode@0.3.0-beta.0"],
+  "permission": {
+    "tokensize_status": "allow",
+    "tokensize_route": "allow",
+    "tokensize_connect": "ask",
+    "tokensize_execute": "ask",
+    "tokensize_feedback": "allow"
+  }
+}
+```
+
+OpenCode execution is inspect-only in this beta. The plugin cannot broaden OpenCode permissions or route back into OpenCode itself.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { Plugin } from '@opencode-ai/plugin';
+
+declare const TokenSizePlugin: Plugin;
+
+export { TokenSizePlugin, TokenSizePlugin as default };

package/dist/index.js

@@ -0,0 +1,80 @@
+// src/index.ts
+import { tool } from "@opencode-ai/plugin";
+import { TokenSizeClient } from "@tokensize/agent-client";
+var TokenSizePlugin = async ({ directory, worktree }) => {
+  const client = new TokenSizeClient({ clientSurface: "opencode-plugin", rootHarness: "opencode", rootActive: true });
+  const contextDirectory = worktree ?? directory;
+  return {
+    tool: {
+      tokensize_status: tool({
+        description: "Inspect locally discovered coding harnesses, models, normalized allowances, and cache freshness.",
+        args: { refresh: tool.schema.boolean().optional(), verbose: tool.schema.boolean().optional() },
+        async execute(args) {
+          return JSON.stringify(await client.status(args), null, 2);
+        }
+      }),
+      tokensize_connect: tool({
+        description: "Open the TokenSize browser authorization flow and save the approved credential locally.",
+        args: {},
+        async execute() {
+          await client.connect("opencode-plugin");
+          return "TokenSize connected. Credentials remain local.";
+        }
+      }),
+      tokensize_route: tool({
+        description: "Preview a privacy-safe TokenSize route; prompts are not shared by default.",
+        args: {
+          task: tool.schema.string().min(1).max(12e3),
+          role: tool.schema.string().optional(),
+          permission: tool.schema.string().optional(),
+          objective: tool.schema.string().optional(),
+          sharePrompt: tool.schema.boolean().optional(),
+          refresh: tool.schema.boolean().optional()
+        },
+        async execute(args) {
+          return JSON.stringify(await client.route({ ...args, role: args.role, permission: args.permission, objective: args.objective }), null, 2);
+        }
+      }),
+      tokensize_execute: tool({
+        description: "Execute an approved inspect-only local route receipt for the exact task it was created for.",
+        args: { receiptId: tool.schema.string().min(36).max(36), task: tool.schema.string().min(1).max(12e3) },
+        async execute(args) {
+          return JSON.stringify(await client.execute({ ...args, cwd: contextDirectory }), null, 2);
+        }
+      }),
+      tokensize_feedback: tool({
+        description: "Send content-free feedback for a recent TokenSize route receipt.",
+        args: {
+          receiptId: tool.schema.string().min(36).max(36),
+          rating: tool.schema.number().int().min(1).max(5),
+          modelChoice: tool.schema.string().min(1).max(20),
+          wouldUseAgain: tool.schema.boolean(),
+          task: tool.schema.string().max(12e3).optional()
+        },
+        async execute(args) {
+          return JSON.stringify(await client.feedback({ receiptId: args.receiptId, rating: args.rating, modelChoice: args.modelChoice, wouldUseAgain: args.wouldUseAgain, task: args.task }), null, 2);
+        }
+      }),
+      tokensize_run_status: tool({
+        description: "Read the Run document for a delegation \u2014 live status, event timeline, approvals, dashboard URL \u2014 or list recent runs. Report the runId and dashboard link instead of pasting route JSON into chat.",
+        args: {
+          runId: tool.schema.string().min(36).max(36).optional(),
+          limit: tool.schema.number().int().min(1).max(100).optional()
+        },
+        async execute(args) {
+          if (args.runId) {
+            const document = await client.runDocument(args.runId);
+            return JSON.stringify({ ...document, dashboard: `https://tokensize.dev/runs/${args.runId}` }, null, 2);
+          }
+          return JSON.stringify(await client.runs({ limit: args.limit }), null, 2);
+        }
+      })
+    }
+  };
+};
+var index_default = TokenSizePlugin;
+export {
+  TokenSizePlugin,
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { type Plugin, tool } from \"@opencode-ai/plugin\";\nimport { TokenSizeClient } from \"@tokensize/agent-client\";\n\nconst TokenSizePlugin: Plugin = async ({ directory, worktree }) => {\n\tconst client = new TokenSizeClient({ clientSurface: \"opencode-plugin\", rootHarness: \"opencode\", rootActive: true });\n\tconst contextDirectory = worktree ?? directory;\n\treturn {\n\t\ttool: {\n\t\t\ttokensize_status: tool({\n\t\t\t\tdescription: \"Inspect locally discovered coding harnesses, models, normalized allowances, and cache freshness.\",\n\t\t\t\targs: { refresh: tool.schema.boolean().optional(), verbose: tool.schema.boolean().optional() },\n\t\t\t\tasync execute(args: { refresh?: boolean; verbose?: boolean }) {\n\t\t\t\t\treturn JSON.stringify(await client.status(args), null, 2);\n\t\t\t\t},\n\t\t\t}),\n\t\t\ttokensize_connect: tool({\n\t\t\t\tdescription: \"Open the TokenSize browser authorization flow and save the approved credential locally.\",\n\t\t\t\targs: {},\n\t\t\t\tasync execute() {\n\t\t\t\t\tawait client.connect(\"opencode-plugin\");\n\t\t\t\t\treturn \"TokenSize connected. Credentials remain local.\";\n\t\t\t\t},\n\t\t\t}),\n\t\t\ttokensize_route: tool({\n\t\t\t\tdescription: \"Preview a privacy-safe TokenSize route; prompts are not shared by default.\",\n\t\t\t\targs: {\n\t\t\t\t\ttask: tool.schema.string().min(1).max(12_000),\n\t\t\t\t\trole: tool.schema.string().optional(),\n\t\t\t\t\tpermission: tool.schema.string().optional(),\n\t\t\t\t\tobjective: tool.schema.string().optional(),\n\t\t\t\t\tsharePrompt: tool.schema.boolean().optional(),\n\t\t\t\t\trefresh: tool.schema.boolean().optional(),\n\t\t\t\t},\n\t\t\t\tasync execute(args: { task: string; role?: never; permission?: never; objective?: never; sharePrompt?: boolean; refresh?: boolean }) {\n\t\t\t\t\treturn JSON.stringify(await client.route({ ...args, role: args.role, permission: args.permission, objective: args.objective }), null, 2);\n\t\t\t\t},\n\t\t\t}),\n\t\t\ttokensize_execute: tool({\n\t\t\t\tdescription: \"Execute an approved inspect-only local route receipt for the exact task it was created for.\",\n\t\t\t\targs: { receiptId: tool.schema.string().min(36).max(36), task: tool.schema.string().min(1).max(12_000) },\n\t\t\t\tasync execute(args: { receiptId: string; task: string }) {\n\t\t\t\t\treturn JSON.stringify(await client.execute({ ...args, cwd: contextDirectory }), null, 2);\n\t\t\t\t},\n\t\t\t}),\n\t\t\ttokensize_feedback: tool({\n\t\t\t\tdescription: \"Send content-free feedback for a recent TokenSize route receipt.\",\n\t\t\t\targs: {\n\t\t\t\t\treceiptId: tool.schema.string().min(36).max(36),\n\t\t\t\t\trating: tool.schema.number().int().min(1).max(5),\n\t\t\t\t\tmodelChoice: tool.schema.string().min(1).max(20),\n\t\t\t\t\twouldUseAgain: tool.schema.boolean(),\n\t\t\t\t\ttask: tool.schema.string().max(12_000).optional(),\n\t\t\t\t},\n\t\t\t\tasync execute(args: { receiptId: string; rating: number; modelChoice: string; wouldUseAgain: boolean; task?: string }) {\n\t\t\t\t\treturn JSON.stringify(await client.feedback({ receiptId: args.receiptId, rating: args.rating as 1 | 2 | 3 | 4 | 5, modelChoice: args.modelChoice as \"right\" | \"acceptable\" | \"wrong\", wouldUseAgain: args.wouldUseAgain, task: args.task }), null, 2);\n\t\t\t\t},\n\t\t\t}),\n\t\t\ttokensize_run_status: tool({\n\t\t\t\tdescription: \"Read the Run document for a delegation — live status, event timeline, approvals, dashboard URL — or list recent runs. Report the runId and dashboard link instead of pasting route JSON into chat.\",\n\t\t\t\targs: {\n\t\t\t\t\trunId: tool.schema.string().min(36).max(36).optional(),\n\t\t\t\t\tlimit: tool.schema.number().int().min(1).max(100).optional(),\n\t\t\t\t},\n\t\t\t\tasync execute(args: { runId?: string; limit?: number }) {\n\t\t\t\t\tif (args.runId) {\n\t\t\t\t\t\tconst document = await client.runDocument(args.runId);\n\t\t\t\t\t\treturn JSON.stringify({ ...document, dashboard: `https://tokensize.dev/runs/${args.runId}` }, null, 2);\n\t\t\t\t\t}\n\t\t\t\t\treturn JSON.stringify(await client.runs({ limit: args.limit }), null, 2);\n\t\t\t\t},\n\t\t\t}),\n\t\t},\n\t};\n};\n\nexport { TokenSizePlugin };\nexport default TokenSizePlugin;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,22 @@
+{
+	"name": "@tokensize/opencode",
+	"version": "0.3.0-beta.0",
+	"description": "TokenSize routing tools for OpenCode",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
+	"files": ["dist", "README.md", "LICENSE"],
+	"repository": { "type": "git", "url": "git+https://github.com/tokensize/tokensize.git", "directory": "packages/opencode" },
+	"homepage": "https://tokensize.dev",
+	"keywords": ["opencode", "ai", "agents", "delegation", "routing"],
+	"publishConfig": { "access": "public", "provenance": true, "tag": "beta" },
+	"engines": { "node": ">=20" },
+	"scripts": { "prebuild": "npm --prefix ../.. run build --workspace @tokensize/agent-client", "build": "tsup", "typecheck": "tsc --noEmit", "test": "vitest run", "prepack": "npm run build", "prepublishOnly": "npm run typecheck && npm test" },
+	"dependencies": {
+		"@opencode-ai/plugin": "1.18.3",
+		"@tokensize/agent-client": "0.3.0-beta.0"
+	},
+	"devDependencies": { "@types/node": "^26.1.1", "tsup": "^8.5.0", "typescript": "^5.5.2", "vitest": "^4.1.10" },
+	"license": "MIT"
+}