@vymalo/opencode-devtools 0.9.0

package/dist/tools.js

@@ -0,0 +1,91 @@
+import { randomBytes as nodeRandomBytes } from "node:crypto";
+import { tool } from "@opencode-ai/plugin";
+import { selectTools } from "./catalog.js";
+const z = tool.schema;
+/** Build the full execution context, applying DI overrides. */
+export function buildContext(options, overrides) {
+    return {
+        options,
+        now: overrides?.now ?? (() => new Date()),
+        randomBytes: overrides?.randomBytes ?? ((size) => nodeRandomBytes(size)),
+        fetchImpl: overrides?.fetchImpl ?? ((...a) => fetch(...a))
+    };
+}
+function fieldToZod(field) {
+    let schema;
+    switch (field.type) {
+        case "string":
+            schema = (field.enum
+                ? z.enum(field.enum)
+                : z.string());
+            break;
+        case "number":
+            schema = z.number();
+            break;
+        case "boolean":
+            schema = z.boolean();
+            break;
+        case "array":
+            schema = z.array(fieldToZod(field.items));
+            break;
+        case "object":
+            schema = z.object(buildShape(field.properties));
+            break;
+        case "record":
+            schema = z.record(z.string(), field.valueType === "any" ? z.any() : z.string());
+            break;
+    }
+    if (field.description) {
+        schema = schema.describe(field.description);
+    }
+    if (field.optional) {
+        schema = schema.optional();
+    }
+    return schema;
+}
+function buildShape(input) {
+    const shape = {};
+    for (const [key, field] of Object.entries(input)) {
+        shape[key] = fieldToZod(field);
+    }
+    return shape;
+}
+/** Render an adapter-neutral result into OpenCode's text-only ToolResult. */
+function renderOpenCode(result) {
+    if (result.kind === "text") {
+        return result.text;
+    }
+    const metadata = typeof result.data === "object" && result.data !== null ? result.data : { value: result.data };
+    return { output: result.text, metadata };
+}
+/**
+ * Build the devtools tool map registered under `Hooks.tool`, filtered to the
+ * enabled groups. Each tool is a thin adapter over the shared catalog: validate
+ * args (zod), run the handler with the execution context, render the result.
+ */
+export function createDevtoolsTools(deps) {
+    const ctx = buildContext(deps.options, deps.context);
+    const tools = {};
+    for (const spec of selectTools(deps.options.groups)) {
+        const definition = {
+            description: spec.description,
+            args: buildShape(spec.input),
+            async execute(args) {
+                deps.logger.trace("devtools_tool_invoked", { tool: spec.name, group: spec.group });
+                try {
+                    const result = await spec.handler(args, ctx);
+                    deps.logger.trace("devtools_tool_completed", { tool: spec.name });
+                    return renderOpenCode(result);
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    deps.logger.warn("devtools_tool_failed", { tool: spec.name, error: message });
+                    throw err;
+                }
+            }
+        };
+        tools[spec.name] = definition;
+    }
+    return tools;
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,38 @@
+import type { ToolGroup } from "./schema.js";
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error";
+export type { ToolGroup } from "./schema.js";
+/**
+ * Per-plugin configuration, supplied as the second argument to the plugin
+ * factory by OpenCode (the `[name, options]` tuple form in `plugin`). All
+ * fields are optional; see DEFAULTS in opencode.ts for the resolved values.
+ */
+export interface DevtoolsPluginOptions {
+    /** Master switch. When false no tools are registered. */
+    enabled?: boolean;
+    /**
+     * Which tool groups to register. The five deterministic, offline groups
+     * (`math`, `codec`, `crypto`, `datetime`, `convert`) are on by default;
+     * `http` performs network egress and is **opt-in** — add it explicitly to
+     * enable it. Per-agent control is also possible via OpenCode's tool
+     * allow/deny on the `math_* / codec_* / …` names.
+     */
+    groups?: ToolGroup[];
+    /** Options for the opt-in `http` group. */
+    http?: HttpOptions;
+}
+export interface HttpOptions {
+    /**
+     * Allow requests to loopback / private / link-local hosts (incl. the cloud
+     * metadata IP `169.254.169.254`). Default `false` — the SSRF guard rejects
+     * them. Turn on only when you intend the model to reach internal services.
+     */
+    allowPrivateNetwork?: boolean;
+    /** Per-request timeout in ms before the call aborts. Default 30000. */
+    timeoutMs?: number;
+}
+/** Fully-resolved options with defaults applied. */
+export interface ResolvedDevtoolsOptions {
+    enabled: boolean;
+    groups: ToolGroup[];
+    http: Required<HttpOptions>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@vymalo/opencode-devtools",
+  "version": "0.9.0",
+  "description": "OpenCode plugin of everyday developer utilities the model can call locally: math (precise arithmetic, unit & base conversion, stats), codec (base64/hex/url, JWT decode, gzip), crypto (hash/hmac, uuid/ulid, random, keypairs), datetime (parse/format/diff, timezones, cron explain), convert (JSON/YAML/TOML/CSV + JSONPath), and an opt-in http client. Deterministic, zero-auth, no server — tools gated into named groups.",
+  "license": "MIT",
+  "author": "vymalo contributors",
+  "homepage": "https://github.com/vymalo/opencode-oauth2#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vymalo/opencode-oauth2.git",
+    "directory": "packages/opencode-devtools"
+  },
+  "bugs": {
+    "url": "https://github.com/vymalo/opencode-oauth2/issues"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "utilities",
+    "math",
+    "crypto",
+    "base64",
+    "jwt",
+    "datetime",
+    "cron",
+    "yaml",
+    "csv",
+    "http",
+    "ai-sdk"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./lib": {
+      "types": "./dist/lib.d.ts",
+      "import": "./dist/lib.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@iarna/toml": "^2.2.5",
+    "@opencode-ai/plugin": "1.15.10",
+    "cron-parser": "^5.5.0",
+    "cronstrue": "^3.20.0",
+    "jsonpath-plus": "^10.4.0",
+    "luxon": "^3.7.2",
+    "mathjs": "^15.2.0",
+    "papaparse": "^5.5.3",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/luxon": "^3.7.1",
+    "@types/papaparse": "^5.5.2",
+    "vite": "^8.0.14",
+    "vitest": "^4.1.7"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "biome lint .",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "coverage": "vitest run --coverage",
+    "format": "biome format --write .",
+    "format:check": "biome format ."
+  }
+}