@vymalo/opencode-devtools 0.9.0

package/dist/groups/math.js

@@ -0,0 +1,139 @@
+import { all, create } from "mathjs";
+import { json, reqNumber, reqString } from "../tool-spec.js";
+/**
+ * A hardened mathjs instance. We use BigNumber for precise decimal arithmetic
+ * and disable every function that can mutate the evaluator or reach outside the
+ * expression sandbox. `evaluate` itself parses mathjs's own expression language
+ * (not JavaScript), so with `import` / `createUnit` / function-assignment
+ * removed there is no path to arbitrary code execution. See plans/devtools.md
+ * and the math-sandbox ADR.
+ */
+const math = create(all, { number: "BigNumber", precision: 64 });
+const disabled = () => {
+    throw new Error("disabled for security");
+};
+math.import({
+    import: disabled,
+    createUnit: disabled,
+    reviver: disabled,
+    splitUnit: disabled
+}, { override: true });
+const RADIX_PREFIX = { 2: "0b", 8: "0o", 16: "0x" };
+function parseInRadix(value, radix) {
+    const trimmed = value.trim().replace(/^0[box]/i, "");
+    // Number.parseInt stops at the first illegal digit (so "1012" in base 2 would
+    // silently parse as 5). Require EVERY digit to be legal for the radix.
+    const allLegal = trimmed.length > 0 &&
+        [...trimmed.toLowerCase()].every((ch) => {
+            const d = Number.parseInt(ch, radix);
+            return !Number.isNaN(d) && d < radix;
+        });
+    if (!allLegal) {
+        throw new Error(`"${value}" is not a valid base-${radix} integer`);
+    }
+    return Number.parseInt(trimmed, radix);
+}
+export const MATH_TOOLS = [
+    {
+        name: "math_eval",
+        group: "math",
+        description: 'Evaluate a mathematical expression with arbitrary-precision (64-digit) decimals. Supports arithmetic, functions (sqrt, log, sin, …), constants (pi, e), and inline unit math (e.g. "3 inch to cm"). Sandboxed: no code execution.',
+        input: {
+            expression: {
+                type: "string",
+                description: 'Expression to evaluate, e.g. "(2 + 3) * 4" or "sqrt(2)" or "5 km to miles".'
+            }
+        },
+        handler: (args) => {
+            const expression = reqString(args, "expression");
+            const result = math.evaluate(expression);
+            const formatted = math.format(result, { precision: 64 });
+            return json({ expression, result: formatted }, formatted);
+        }
+    },
+    {
+        name: "math_convert_unit",
+        group: "math",
+        description: "Convert a physical quantity from one unit to another (length, mass, time, temperature, data, energy, …). Returns the converted value.",
+        input: {
+            value: { type: "number", description: "Numeric magnitude to convert." },
+            from: { type: "string", description: 'Source unit, e.g. "km", "kg", "celsius", "GB".' },
+            to: { type: "string", description: 'Target unit, e.g. "miles", "lbs", "fahrenheit", "MB".' }
+        },
+        handler: (args) => {
+            const value = reqNumber(args, "value");
+            const from = reqString(args, "from");
+            const to = reqString(args, "to");
+            const converted = math.evaluate(`${value} ${from} to ${to}`);
+            const formatted = math.format(converted, { precision: 14 });
+            return json({ value, from, to, result: formatted }, `${value} ${from} = ${formatted}`);
+        }
+    },
+    {
+        name: "math_stats",
+        group: "math",
+        description: "Compute descriptive statistics over a list of numbers: count, sum, min, max, mean, median, mode, variance and standard deviation.",
+        input: {
+            values: { type: "array", items: { type: "number" }, description: "The numbers to summarize." }
+        },
+        handler: (args) => {
+            const raw = args.values;
+            if (!Array.isArray(raw) || raw.length === 0) {
+                throw new Error('"values" must be a non-empty array of numbers');
+            }
+            const values = raw.map((v, i) => {
+                if (typeof v !== "number" || Number.isNaN(v)) {
+                    throw new Error(`values[${i}] is not a number`);
+                }
+                return v;
+            });
+            const num = (x) => Number(math.format(x, { precision: 14 }));
+            const stats = {
+                count: values.length,
+                sum: num(math.sum(values)),
+                min: num(math.min(values)),
+                max: num(math.max(values)),
+                mean: num(math.mean(values)),
+                median: num(math.median(values)),
+                mode: math.mode(values).map(num),
+                variance: num(math.variance(values)),
+                stdev: num(math.std(values))
+            };
+            return json(stats, `n=${stats.count} mean=${stats.mean} median=${stats.median} stdev=${stats.stdev} min=${stats.min} max=${stats.max}`);
+        }
+    },
+    {
+        name: "math_base",
+        group: "math",
+        description: "Convert an integer between numeric bases (radix 2–36). Common bases (binary, octal, decimal, hex) are returned alongside the requested target.",
+        input: {
+            value: { type: "string", description: 'Integer to convert, e.g. "255" or "0xff" or "1011".' },
+            fromBase: { type: "number", description: "Base of the input value (2–36)." },
+            toBase: { type: "number", description: "Base to convert to (2–36)." }
+        },
+        handler: (args) => {
+            const value = reqString(args, "value");
+            const fromBase = reqNumber(args, "fromBase");
+            const toBase = reqNumber(args, "toBase");
+            for (const [label, b] of [
+                ["fromBase", fromBase],
+                ["toBase", toBase]
+            ]) {
+                if (!Number.isInteger(b) || b < 2 || b > 36) {
+                    throw new Error(`"${label}" must be an integer in 2–36`);
+                }
+            }
+            const n = parseInRadix(value, fromBase);
+            const out = n.toString(toBase);
+            const prefix = RADIX_PREFIX[toBase] ?? "";
+            return json({
+                decimal: n,
+                result: out,
+                binary: n.toString(2),
+                octal: n.toString(8),
+                hex: n.toString(16)
+            }, `${value} (base ${fromBase}) = ${prefix}${out} (base ${toBase})`);
+        }
+    }
+];
+//# sourceMappingURL=math.js.map

package/dist/groups/math.js.map

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

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { default } from "./opencode.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+// Intentionally tiny. OpenCode iterates every named export of the main entry
+// and rejects anything that isn't a `Plugin` function, so the only thing this
+// module exposes is the default plugin. Library/utility exports live in
+// `./lib` (see lib.ts), which OpenCode never inspects.
+export { default } from "./opencode.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,wEAAwE;AACxE,uDAAuD;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/lib.d.ts

@@ -0,0 +1,7 @@
+export { createDevtoolsPlugin, type DevtoolsPluginFactoryOptions, OpencodeDevtoolsPlugin, resolveOptions } from "./opencode.js";
+export { DEFAULT_GROUPS, DEVTOOLS_TOOLS, type NeutralResult, selectTools, TOOL_GROUPS, type ToolContext, type ToolGroup, type ToolSpec } from "./catalog.js";
+export { buildContext, createDevtoolsTools, type ToolDeps } from "./tools.js";
+export { type Field, type JsonInput, type JsonSchema, toJsonSchema } from "./schema.js";
+export { json, optBool, optString, reqNumber, reqString, text } from "./tool-spec.js";
+export { createJsonConsoleLogger, DEFAULT_LOG_LEVEL, fromOpenCodeLogLevel, type LogFields, type Logger, type LogLevel } from "./logging.js";
+export type { DevtoolsPluginOptions, HttpOptions, ResolvedDevtoolsOptions } from "./types.js";

package/dist/lib.js

@@ -0,0 +1,7 @@
+export { createDevtoolsPlugin, OpencodeDevtoolsPlugin, resolveOptions } from "./opencode.js";
+export { DEFAULT_GROUPS, DEVTOOLS_TOOLS, selectTools, TOOL_GROUPS } from "./catalog.js";
+export { buildContext, createDevtoolsTools } from "./tools.js";
+export { toJsonSchema } from "./schema.js";
+export { json, optBool, optString, reqNumber, reqString, text } from "./tool-spec.js";
+export { createJsonConsoleLogger, DEFAULT_LOG_LEVEL, fromOpenCodeLogLevel } from "./logging.js";
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EAEpB,sBAAsB,EACtB,cAAc,EACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,cAAc,EAEd,WAAW,EACX,WAAW,EAIZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAiB,MAAM,YAAY,CAAC;AAE9E,OAAO,EAA+C,YAAY,EAAE,MAAM,aAAa,CAAC;AAExF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtF,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EAIrB,MAAM,cAAc,CAAC"}

package/dist/logging.d.ts

@@ -0,0 +1,16 @@
+import type { LogLevel } from "./types.js";
+export type { LogLevel } from "./types.js";
+export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
+export declare const DEFAULT_LOG_LEVEL: LogLevel;
+export interface LogFields {
+    [key: string]: unknown;
+}
+export interface Logger {
+    trace(event: string, fields?: LogFields): void;
+    debug(event: string, fields?: LogFields): void;
+    info(event: string, fields?: LogFields): void;
+    warn(event: string, fields?: LogFields): void;
+    error(event: string, fields?: LogFields): void;
+}
+export declare function createJsonConsoleLogger(minLevel?: LogLevel): Logger;
+export declare function fromOpenCodeLogLevel(value: unknown): LogLevel | undefined;

package/dist/logging.js

@@ -0,0 +1,72 @@
+export const LOG_LEVEL_PRIORITY = {
+    trace: 5,
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40
+};
+export const DEFAULT_LOG_LEVEL = "info";
+function redactFields(fields) {
+    if (!fields) {
+        return undefined;
+    }
+    const redacted = {};
+    for (const [key, value] of Object.entries(fields)) {
+        if (/token|secret|password|authorization/i.test(key)) {
+            redacted[key] = "[redacted]";
+            continue;
+        }
+        redacted[key] = value;
+    }
+    return redacted;
+}
+export function createJsonConsoleLogger(minLevel = DEFAULT_LOG_LEVEL) {
+    const minPriority = LOG_LEVEL_PRIORITY[minLevel];
+    const write = (level, event, fields) => {
+        if (LOG_LEVEL_PRIORITY[level] < minPriority) {
+            return;
+        }
+        const payload = {
+            ts: new Date().toISOString(),
+            level,
+            event,
+            ...(redactFields(fields) ?? {})
+        };
+        const line = JSON.stringify(payload);
+        if (level === "error") {
+            console.error(line);
+            return;
+        }
+        if (level === "warn") {
+            console.warn(line);
+            return;
+        }
+        console.log(line);
+    };
+    return {
+        trace: (event, fields) => write("trace", event, fields),
+        debug: (event, fields) => write("debug", event, fields),
+        info: (event, fields) => write("info", event, fields),
+        warn: (event, fields) => write("warn", event, fields),
+        error: (event, fields) => write("error", event, fields)
+    };
+}
+export function fromOpenCodeLogLevel(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    switch (value.toUpperCase()) {
+        case "DEBUG":
+            // Host DEBUG unlocks our most-verbose internal tier (trace).
+            return "trace";
+        case "INFO":
+            return "info";
+        case "WARN":
+            return "warn";
+        case "ERROR":
+            return "error";
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

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

package/dist/opencode.d.ts

@@ -0,0 +1,14 @@
+import type { Plugin, PluginOptions } from "@opencode-ai/plugin";
+import { type Logger } from "./logging.js";
+import { type ToolDeps } from "./tools.js";
+import type { ResolvedDevtoolsOptions } from "./types.js";
+export interface DevtoolsPluginFactoryOptions {
+    /** Inject a logger (defaults to the OpenCode-piped logger). */
+    logger?: Logger;
+    /** Inject the tool execution context (clock / randomness / fetch) for tests. */
+    context?: ToolDeps["context"];
+}
+export declare function resolveOptions(raw: PluginOptions | undefined): ResolvedDevtoolsOptions;
+export declare function createDevtoolsPlugin(factoryOptions?: DevtoolsPluginFactoryOptions): Plugin;
+export declare const OpencodeDevtoolsPlugin: Plugin;
+export default OpencodeDevtoolsPlugin;

package/dist/opencode.js

@@ -0,0 +1,91 @@
+import { DEFAULT_GROUPS, TOOL_GROUPS } from "./catalog.js";
+import { createJsonConsoleLogger, DEFAULT_LOG_LEVEL, fromOpenCodeLogLevel, LOG_LEVEL_PRIORITY } from "./logging.js";
+import { createDevtoolsTools } from "./tools.js";
+const PLUGIN_SERVICE_NAME = "opencode-devtools-plugin";
+const DEFAULTS = {
+    httpTimeoutMs: 30_000
+};
+function resolveGroups(raw) {
+    if (!Array.isArray(raw)) {
+        return [...DEFAULT_GROUPS];
+    }
+    const valid = raw.filter((g) => TOOL_GROUPS.includes(g));
+    // An explicit but empty/invalid list falls back to the defaults rather than
+    // registering nothing — matches the browser plugin's behaviour.
+    return valid.length > 0 ? Array.from(new Set(valid)) : [...DEFAULT_GROUPS];
+}
+export function resolveOptions(raw) {
+    const opts = (raw ?? {});
+    return {
+        enabled: opts.enabled !== false,
+        groups: resolveGroups(opts.groups),
+        http: {
+            allowPrivateNetwork: opts.http?.allowPrivateNetwork === true,
+            timeoutMs: typeof opts.http?.timeoutMs === "number" && opts.http.timeoutMs > 0
+                ? opts.http.timeoutMs
+                : DEFAULTS.httpTimeoutMs
+        }
+    };
+}
+/**
+ * Pipe plugin logs through OpenCode's `client.app.log` so they show up in the
+ * host's structured log stream, with the JSON console as a reliable fallback.
+ * Mirrors `@vymalo/opencode-browser`.
+ */
+function createOpenCodeLogger(client, getMinLevel) {
+    const fallback = createJsonConsoleLogger("debug");
+    const consoleAll = /^(1|true|yes|on)$/i.test(process.env.VYMALO_PLUGIN_CONSOLE_LOG ?? "");
+    const write = (level, event, fields) => {
+        if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[getMinLevel()]) {
+            return;
+        }
+        if (consoleAll || level === "warn" || level === "error") {
+            fallback[level](event, fields);
+        }
+        const hostLevel = level === "trace" ? "debug" : level;
+        void client.app
+            .log({
+            body: { service: PLUGIN_SERVICE_NAME, level: hostLevel, message: event, extra: fields }
+        })
+            .catch(() => {
+            /* best-effort */
+        });
+    };
+    return {
+        trace: (event, fields) => write("trace", event, fields),
+        debug: (event, fields) => write("debug", event, fields),
+        info: (event, fields) => write("info", event, fields),
+        warn: (event, fields) => write("warn", event, fields),
+        error: (event, fields) => write("error", event, fields)
+    };
+}
+export function createDevtoolsPlugin(factoryOptions = {}) {
+    return async ({ client }, pluginOptions) => {
+        let currentLogLevel = DEFAULT_LOG_LEVEL;
+        const logger = factoryOptions.logger ?? createOpenCodeLogger(client, () => currentLogLevel);
+        const options = resolveOptions(pluginOptions);
+        if (!options.enabled) {
+            logger.info("devtools_plugin_disabled", {});
+            return {
+                config: async (config) => {
+                    currentLogLevel = fromOpenCodeLogLevel(config.logLevel) ?? DEFAULT_LOG_LEVEL;
+                }
+            };
+        }
+        logger.info("devtools_plugin_enabled", { groups: options.groups });
+        const tools = createDevtoolsTools({
+            options,
+            logger,
+            context: factoryOptions.context
+        });
+        return {
+            tool: tools,
+            config: async (config) => {
+                currentLogLevel = fromOpenCodeLogLevel(config.logLevel) ?? DEFAULT_LOG_LEVEL;
+            }
+        };
+    };
+}
+export const OpencodeDevtoolsPlugin = createDevtoolsPlugin();
+export default OpencodeDevtoolsPlugin;
+//# sourceMappingURL=opencode.js.map

package/dist/opencode.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,63 @@
+/**
+ * A tiny, neutral schema vocabulary for tool arguments. The tool catalog
+ * (`catalog.ts`) is the single source of truth; each adapter turns these specs
+ * into its own format:
+ *   - the OpenCode plugin builds a zod shape (see `buildShape` in tools.ts),
+ *   - the MCP server emits standard JSON Schema via `toJsonSchema` below.
+ *
+ * Lifted verbatim from `@vymalo/opencode-browser` so the two tool-registering
+ * plugins describe their surface the same way. Keeping the vocabulary small
+ * avoids dragging a specific zod version across the package boundary.
+ */
+export type ToolGroup = "math" | "codec" | "crypto" | "datetime" | "convert" | "http";
+export interface StringField {
+    type: "string";
+    description?: string;
+    optional?: boolean;
+    enum?: readonly string[];
+}
+export interface NumberField {
+    type: "number";
+    description?: string;
+    optional?: boolean;
+}
+export interface BooleanField {
+    type: "boolean";
+    description?: string;
+    optional?: boolean;
+}
+export interface ArrayField {
+    type: "array";
+    description?: string;
+    optional?: boolean;
+    items: Field;
+}
+export interface ObjectField {
+    type: "object";
+    description?: string;
+    optional?: boolean;
+    properties: Record<string, Field>;
+}
+/**
+ * An open key→value map with arbitrary keys (e.g. HTTP headers, GraphQL
+ * variables). Unlike `object`, it does NOT set `additionalProperties: false`,
+ * so real keys aren't stripped/rejected by a validating client. `valueType`
+ * picks the value schema (`string` for headers, `any` for variables).
+ */
+export interface RecordField {
+    type: "record";
+    description?: string;
+    optional?: boolean;
+    valueType?: "string" | "any";
+}
+export type Field = StringField | NumberField | BooleanField | ArrayField | ObjectField | RecordField;
+/** Top-level argument map for a tool. */
+export type JsonInput = Record<string, Field>;
+export interface JsonSchema {
+    type: "object";
+    properties: Record<string, unknown>;
+    required: string[];
+    additionalProperties: false;
+}
+/** Convert a tool's input spec to a standard JSON Schema object (for MCP). */
+export declare function toJsonSchema(input: JsonInput): JsonSchema;

package/dist/schema.js

@@ -0,0 +1,54 @@
+/**
+ * A tiny, neutral schema vocabulary for tool arguments. The tool catalog
+ * (`catalog.ts`) is the single source of truth; each adapter turns these specs
+ * into its own format:
+ *   - the OpenCode plugin builds a zod shape (see `buildShape` in tools.ts),
+ *   - the MCP server emits standard JSON Schema via `toJsonSchema` below.
+ *
+ * Lifted verbatim from `@vymalo/opencode-browser` so the two tool-registering
+ * plugins describe their surface the same way. Keeping the vocabulary small
+ * avoids dragging a specific zod version across the package boundary.
+ */
+function fieldToJsonSchema(field) {
+    const out = { type: field.type };
+    if (field.description) {
+        out.description = field.description;
+    }
+    if (field.type === "string" && field.enum) {
+        out.enum = [...field.enum];
+    }
+    if (field.type === "array") {
+        out.items = fieldToJsonSchema(field.items);
+    }
+    if (field.type === "record") {
+        out.type = "object";
+        out.additionalProperties = field.valueType === "any" ? true : { type: "string" };
+    }
+    if (field.type === "object") {
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(field.properties)) {
+            properties[key] = fieldToJsonSchema(value);
+            if (!value.optional) {
+                required.push(key);
+            }
+        }
+        out.properties = properties;
+        out.required = required;
+        out.additionalProperties = false;
+    }
+    return out;
+}
+/** Convert a tool's input spec to a standard JSON Schema object (for MCP). */
+export function toJsonSchema(input) {
+    const properties = {};
+    const required = [];
+    for (const [key, field] of Object.entries(input)) {
+        properties[key] = fieldToJsonSchema(field);
+        if (!field.optional) {
+            required.push(key);
+        }
+    }
+    return { type: "object", properties, required, additionalProperties: false };
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA8DH,SAAS,iBAAiB,CAAC,KAAY;IACrC,MAAM,GAAG,GAA4B,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1C,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3B,GAAG,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC;QACpB,GAAG,CAAC,oBAAoB,GAAG,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACnF,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,UAAU,GAA4B,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,UAAU,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACpB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QACD,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;QAC5B,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACxB,GAAG,CAAC,oBAAoB,GAAG,KAAK,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,UAAU,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC;AAC/E,CAAC"}

package/dist/tool-spec.d.ts

@@ -0,0 +1,44 @@
+import type { JsonInput, ToolGroup } from "./schema.js";
+import type { ResolvedDevtoolsOptions } from "./types.js";
+/**
+ * Execution context handed to every tool handler. The clock, randomness and
+ * fetch are injected (not imported) so the deterministic groups stay unit-
+ * testable: a test pins `now`/`randomBytes` and asserts exact output, and the
+ * `http` group runs against a fake `fetchImpl` with no network.
+ */
+export interface ToolContext {
+    options: ResolvedDevtoolsOptions;
+    /** Current time. Default `() => new Date()`. */
+    now: () => Date;
+    /** Cryptographically-strong random bytes. Default `node:crypto.randomBytes`. */
+    randomBytes: (size: number) => Buffer;
+    /** Fetch implementation for the `http` group. Default the global `fetch`. */
+    fetchImpl: typeof fetch;
+}
+/**
+ * Adapter-neutral result of a tool call. `text` is always the self-sufficient
+ * human/agent-readable output; `data` (json only) carries optional structured
+ * metadata the OpenCode adapter surfaces as `metadata`. There is no image
+ * variant — unlike the browser plugin, devtools tools return text/json only.
+ */
+export type NeutralResult = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "json";
+    text: string;
+    data: unknown;
+};
+export interface ToolSpec {
+    name: string;
+    group: ToolGroup;
+    description: string;
+    input: JsonInput;
+    handler: (args: Record<string, unknown>, ctx: ToolContext) => NeutralResult | Promise<NeutralResult>;
+}
+export declare const text: (t: string) => NeutralResult;
+export declare const json: (data: unknown, t: string) => NeutralResult;
+export declare function reqString(args: Record<string, unknown>, key: string): string;
+export declare function optString(args: Record<string, unknown>, key: string): string | undefined;
+export declare function reqNumber(args: Record<string, unknown>, key: string): number;
+export declare function optBool(args: Record<string, unknown>, key: string): boolean | undefined;

package/dist/tool-spec.js

@@ -0,0 +1,27 @@
+// ─── result builders ─────────────────────────────────────────────────────────
+export const text = (t) => ({ kind: "text", text: t });
+export const json = (data, t) => ({ kind: "json", data, text: t });
+// ─── arg coercion (args are pre-validated by the adapter's schema) ───────────
+export function reqString(args, key) {
+    const v = args[key];
+    if (typeof v !== "string") {
+        throw new Error(`"${key}" must be a string`);
+    }
+    return v;
+}
+export function optString(args, key) {
+    const v = args[key];
+    return typeof v === "string" ? v : undefined;
+}
+export function reqNumber(args, key) {
+    const v = args[key];
+    if (typeof v !== "number" || Number.isNaN(v)) {
+        throw new Error(`"${key}" must be a number`);
+    }
+    return v;
+}
+export function optBool(args, key) {
+    const v = args[key];
+    return typeof v === "boolean" ? v : undefined;
+}
+//# sourceMappingURL=tool-spec.js.map

package/dist/tool-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-spec.js","sourceRoot":"","sources":["../src/tool-spec.ts"],"names":[],"mappings":"AAwCA,gFAAgF;AAChF,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,IAAa,EAAE,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAEnG,gFAAgF;AAChF,MAAM,UAAU,SAAS,CAAC,IAA6B,EAAE,GAAW;IAClE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,oBAAoB,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAA6B,EAAE,GAAW;IAClE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAA6B,EAAE,GAAW;IAClE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,oBAAoB,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAA6B,EAAE,GAAW;IAChE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,OAAO,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,18 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { Logger } from "./logging.js";
+import type { ToolContext } from "./tool-spec.js";
+import type { ResolvedDevtoolsOptions } from "./types.js";
+export interface ToolDeps {
+    options: ResolvedDevtoolsOptions;
+    logger: Logger;
+    /** Inject the execution context (clock / randomness / fetch) for tests. */
+    context?: Partial<Omit<ToolContext, "options">>;
+}
+/** Build the full execution context, applying DI overrides. */
+export declare function buildContext(options: ResolvedDevtoolsOptions, overrides?: Partial<Omit<ToolContext, "options">>): ToolContext;
+/**
+ * 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 declare function createDevtoolsTools(deps: ToolDeps): Record<string, ToolDefinition>;