@vymalo/opencode-devtools 0.11.0 → 0.14.0

package/dist/opencode.js

@@ -2,90 +2,86 @@ 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
-};
+const DEFAULTS = { httpTimeoutMs: 3e4 };
 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];
+	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
-        }
-    };
+	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`.
- */
+* 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)
-    };
+	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;
-            }
-        };
-    };
+	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

@@ -1 +1 @@
-{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../src/opencode.ts"],"names":[],"mappings":"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"}
+{"mappings":"AAEA,SAAS,gBAAgB,mBAAmB;AAC5C,SACE,yBACA,mBACA,sBAEA,0BAGK;AAEP,SAAS,2BAA0C;AAGnD,MAAM,sBAAsB;AAE5B,MAAM,WAAW,EACf,eAAe,IACjB;AAWA,SAAS,cAAc,KAA2B;CAChD,IAAI,CAAC,MAAM,QAAQ,GAAG,GAAG;EACvB,OAAO,CAAC,GAAG,cAAc;CAC3B;CACA,MAAM,QAAQ,IAAI,QAAQ,MAAsB,YAAY,SAAS,CAAc,CAAC;;;CAGpF,OAAO,MAAM,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc;AAC3E;AAEA,OAAO,SAAS,eAAe,KAAyD;CACtF,MAAM,OAAQ,OAAO,CAAC;CACtB,OAAO;EACL,SAAS,KAAK,YAAY;EAC1B,QAAQ,cAAc,KAAK,MAAM;EACjC,MAAM;GACJ,qBAAqB,KAAK,MAAM,wBAAwB;GACxD,WACE,OAAO,KAAK,MAAM,cAAc,YAAY,KAAK,KAAK,YAAY,IAC9D,KAAK,KAAK,YACV,SAAS;EACjB;CACF;AACF;;;;;;AAOA,SAAS,qBAAqB,QAA+B,aAAqC;CAChG,MAAM,WAAW,wBAAwB,OAAO;CAChD,MAAM,aAAa,qBAAqB,KAAK,QAAQ,IAAI,6BAA6B,EAAE;CAExF,MAAM,SAAS,OAAiB,OAAe,WAAuB;EACpE,IAAI,mBAAmB,SAAS,mBAAmB,YAAY,IAAI;GACjE;EACF;EACA,IAAI,cAAc,UAAU,UAAU,UAAU,SAAS;GACvD,SAAS,MAAM,CAAC,OAAO,MAAM;EAC/B;EACA,MAAM,YAAY,UAAU,UAAU,UAAU;EAChD,KAAK,OAAO,IACT,IAAI,EACH,MAAM;GAAE,SAAS;GAAqB,OAAO;GAAW,SAAS;GAAO,OAAO;EAAO,EACxF,CAAC,CAAC,CACD,YAAY;;EAEb,CAAC;CACL;CAEA,OAAO;EACL,QAAQ,OAAO,WAAW,MAAM,SAAS,OAAO,MAAM;EACtD,QAAQ,OAAO,WAAW,MAAM,SAAS,OAAO,MAAM;EACtD,OAAO,OAAO,WAAW,MAAM,QAAQ,OAAO,MAAM;EACpD,OAAO,OAAO,WAAW,MAAM,QAAQ,OAAO,MAAM;EACpD,QAAQ,OAAO,WAAW,MAAM,SAAS,OAAO,MAAM;CACxD;AACF;AAEA,OAAO,SAAS,qBAAqB,iBAA+C,CAAC,GAAW;CAC9F,OAAO,OAAO,EAAE,UAAU,kBAAkB;EAC1C,IAAI,kBAA4B;EAChC,MAAM,SAAS,eAAe,UAAU,qBAAqB,cAAc,eAAe;EAE1F,MAAM,UAAU,eAAe,aAAa;EAE5C,IAAI,CAAC,QAAQ,SAAS;GACpB,OAAO,KAAK,4BAA4B,CAAC,CAAC;GAC1C,OAAO,EACL,QAAQ,OAAO,WAA2B;IACxC,kBAAkB,qBAAqB,OAAO,QAAQ,KAAK;GAC7D,EACF;EACF;EAEA,OAAO,KAAK,2BAA2B,EAAE,QAAQ,QAAQ,OAAO,CAAC;EAEjE,MAAM,QAAQ,oBAAoB;GAChC;GACA;GACA,SAAS,eAAe;EAC1B,CAAC;EAED,OAAO;GACL,MAAM;GACN,QAAQ,OAAO,WAA2B;IACxC,kBAAkB,qBAAqB,OAAO,QAAQ,KAAK;GAC7D;EACF;CACF;AACF;AAEA,OAAO,MAAM,yBAAiC,qBAAqB;AAEnE,eAAe","names":[],"sources":["../src/opencode.ts"],"version":3,"file":"opencode.js","sourceRoot":""}

package/dist/schema.d.ts

@@ -1,63 +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.
- */
+* 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[];
+	type: "string";
+	description?: string;
+	optional?: boolean;
+	enum?: readonly string[];
 }
 export interface NumberField {
-    type: "number";
-    description?: string;
-    optional?: boolean;
+	type: "number";
+	description?: string;
+	optional?: boolean;
 }
 export interface BooleanField {
-    type: "boolean";
-    description?: string;
-    optional?: boolean;
+	type: "boolean";
+	description?: string;
+	optional?: boolean;
 }
 export interface ArrayField {
-    type: "array";
-    description?: string;
-    optional?: boolean;
-    items: Field;
+	type: "array";
+	description?: string;
+	optional?: boolean;
+	items: Field;
 }
 export interface ObjectField {
-    type: "object";
-    description?: string;
-    optional?: boolean;
-    properties: Record<string, Field>;
+	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).
- */
+* 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";
+	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;
+	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

@@ -1,54 +1,49 @@
-/**
- * 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;
+	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 };
+	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

@@ -1 +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"}
+{"mappings":"AAwEA,SAAS,kBAAkB,OAAuC;CAChE,MAAM,MAA+B,EAAE,MAAM,MAAM,KAAK;CACxD,IAAI,MAAM,aAAa;EACrB,IAAI,cAAc,MAAM;CAC1B;CACA,IAAI,MAAM,SAAS,YAAY,MAAM,MAAM;EACzC,IAAI,OAAO,CAAC,GAAG,MAAM,IAAI;CAC3B;CACA,IAAI,MAAM,SAAS,SAAS;EAC1B,IAAI,QAAQ,kBAAkB,MAAM,KAAK;CAC3C;CACA,IAAI,MAAM,SAAS,UAAU;EAC3B,IAAI,OAAO;EACX,IAAI,uBAAuB,MAAM,cAAc,QAAQ,OAAO,EAAE,MAAM,SAAS;CACjF;CACA,IAAI,MAAM,SAAS,UAAU;EAC3B,MAAM,aAAsC,CAAC;EAC7C,MAAM,WAAqB,CAAC;EAC5B,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,UAAU,GAAG;GAC3D,WAAW,OAAO,kBAAkB,KAAK;GACzC,IAAI,CAAC,MAAM,UAAU;IACnB,SAAS,KAAK,GAAG;GACnB;EACF;EACA,IAAI,aAAa;EACjB,IAAI,WAAW;EACf,IAAI,uBAAuB;CAC7B;CACA,OAAO;AACT;;AAGA,OAAO,SAAS,aAAa,OAA8B;CACzD,MAAM,aAAsC,CAAC;CAC7C,MAAM,WAAqB,CAAC;CAC5B,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;EAChD,WAAW,OAAO,kBAAkB,KAAK;EACzC,IAAI,CAAC,MAAM,UAAU;GACnB,SAAS,KAAK,GAAG;EACnB;CACF;CACA,OAAO;EAAE,MAAM;EAAU;EAAY;EAAU,sBAAsB;CAAM;AAC7E","names":[],"sources":["../src/schema.ts"],"version":3,"file":"schema.js","sourceRoot":""}

package/dist/tool-spec.d.ts

@@ -1,40 +1,40 @@
 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.
- */
+* 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;
+	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.
- */
+* 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: "text";
+	text: string;
 } | {
-    kind: "json";
-    text: string;
-    data: unknown;
+	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>;
+	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;

package/dist/tool-spec.js

@@ -1,27 +1,35 @@
 // ─── result builders ─────────────────────────────────────────────────────────
-export const text = (t) => ({ kind: "text", text: t });
-export const json = (data, t) => ({ kind: "json", data, text: t });
+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;
+	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;
+	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;
+	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;
+	const v = args[key];
+	return typeof v === "boolean" ? v : undefined;
 }
+
 //# sourceMappingURL=tool-spec.js.map

package/dist/tool-spec.js.map

@@ -1 +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"}
+{"mappings":";AAyCA,OAAO,MAAM,QAAQ,OAA8B;CAAE,MAAM;CAAQ,MAAM;AAAE;AAC3E,OAAO,MAAM,QAAQ,MAAe,OAA8B;CAAE,MAAM;CAAQ;CAAM,MAAM;AAAE;;AAGhG,OAAO,SAAS,UAAU,MAA+B,KAAqB;CAC5E,MAAM,IAAI,KAAK;CACf,IAAI,OAAO,MAAM,UAAU;EACzB,MAAM,IAAI,MAAM,IAAI,IAAI,mBAAmB;CAC7C;CACA,OAAO;AACT;AAEA,OAAO,SAAS,UAAU,MAA+B,KAAiC;CACxF,MAAM,IAAI,KAAK;CACf,OAAO,OAAO,MAAM,WAAW,IAAI;AACrC;AAEA,OAAO,SAAS,UAAU,MAA+B,KAAqB;CAC5E,MAAM,IAAI,KAAK;CACf,IAAI,OAAO,MAAM,YAAY,OAAO,MAAM,CAAC,GAAG;EAC5C,MAAM,IAAI,MAAM,IAAI,IAAI,mBAAmB;CAC7C;CACA,OAAO;AACT;AAEA,OAAO,SAAS,QAAQ,MAA+B,KAAkC;CACvF,MAAM,IAAI,KAAK;CACf,OAAO,OAAO,MAAM,YAAY,IAAI;AACtC","names":[],"sources":["../src/tool-spec.ts"],"version":3,"file":"tool-spec.js","sourceRoot":""}

package/dist/tools.d.ts

@@ -3,16 +3,16 @@ 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">>;
+	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.
- */
+* 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>;