@jshookmcp/jshook 0.2.7 → 0.2.9

package/dist/tool-builder-DCbIC5Eo.mjs

@@ -0,0 +1,186 @@
+//#region src/server/registry/tool-builder.ts
+function createInitialState(name) {
+	return {
+		name,
+		description: "",
+		properties: {},
+		required: [],
+		annotations: {
+			readOnlyHint: false,
+			destructiveHint: false,
+			idempotentHint: false,
+			openWorldHint: false
+		},
+		asyncTask: false,
+		autocompleteHandlers: {},
+		outputSchema: void 0
+	};
+}
+function defaults(opts) {
+	if (opts?.default === void 0) return {};
+	return { default: opts.default };
+}
+function withState(state, patch) {
+	return {
+		...state,
+		...patch
+	};
+}
+function withProperty(state, name, schema) {
+	return withState(state, { properties: {
+		...state.properties,
+		[name]: schema
+	} });
+}
+function withRequiredNames(state, names) {
+	return withState(state, { required: [...state.required, ...names] });
+}
+function withAnnotations(state, patch) {
+	return withState(state, { annotations: {
+		...state.annotations,
+		...patch
+	} });
+}
+function buildTool(state) {
+	return {
+		name: state.name,
+		description: state.description,
+		inputSchema: {
+			type: "object",
+			properties: state.properties,
+			...state.required.length > 0 ? { required: [...state.required] } : {}
+		},
+		annotations: {
+			readOnlyHint: state.annotations.readOnlyHint,
+			destructiveHint: state.annotations.destructiveHint,
+			idempotentHint: state.annotations.idempotentHint,
+			openWorldHint: state.annotations.openWorldHint
+		},
+		...state.asyncTask ? { execution: { taskSupport: "optional" } } : {},
+		...Object.keys(state.autocompleteHandlers).length > 0 ? { __autocomplete: state.autocompleteHandlers } : {},
+		...state.outputSchema ? { outputSchema: state.outputSchema } : {}
+	};
+}
+function createBuilder(state, tracker) {
+	const next = (updated) => {
+		const nextBuilder = createBuilder(updated, tracker);
+		if (tracker) tracker.latest = nextBuilder;
+		return nextBuilder;
+	};
+	const builder = {
+		desc(description) {
+			return next(withState(state, { description }));
+		},
+		string(name, description, opts) {
+			const schema = {
+				type: "string",
+				description,
+				...defaults(opts)
+			};
+			if (opts?.pattern) schema.pattern = opts.pattern;
+			return next(withProperty(state, name, schema));
+		},
+		number(name, description, opts) {
+			const schema = {
+				type: "number",
+				description,
+				...defaults(opts)
+			};
+			if (opts?.minimum !== void 0) schema.minimum = opts.minimum;
+			if (opts?.maximum !== void 0) schema.maximum = opts.maximum;
+			return next(withProperty(state, name, schema));
+		},
+		integer(name, description, opts) {
+			const schema = {
+				type: "integer",
+				description,
+				...defaults(opts)
+			};
+			if (opts?.minimum !== void 0) schema.minimum = opts.minimum;
+			if (opts?.maximum !== void 0) schema.maximum = opts.maximum;
+			return next(withProperty(state, name, schema));
+		},
+		boolean(name, description, opts) {
+			return next(withProperty(state, name, {
+				type: "boolean",
+				description,
+				...defaults(opts)
+			}));
+		},
+		enum(name, values, description, opts) {
+			return next(withProperty(state, name, {
+				type: "string",
+				enum: values,
+				description,
+				...defaults(opts)
+			}));
+		},
+		array(name, items, description) {
+			return next(withProperty(state, name, {
+				type: "array",
+				items,
+				description
+			}));
+		},
+		object(name, props, description, opts) {
+			return next(withProperty(state, name, {
+				type: "object",
+				properties: props,
+				description,
+				...opts?.required ? { required: opts.required } : {}
+			}));
+		},
+		prop(name, schema) {
+			return next(withProperty(state, name, schema));
+		},
+		required(...names) {
+			return next(withRequiredNames(state, names));
+		},
+		requiredOpenWorld(...names) {
+			return this.required(...names).openWorld();
+		},
+		readOnly() {
+			return next(withAnnotations(state, { readOnlyHint: true }));
+		},
+		destructive() {
+			return next(withAnnotations(state, { destructiveHint: true }));
+		},
+		idempotent() {
+			return next(withAnnotations(state, { idempotentHint: true }));
+		},
+		openWorld() {
+			return next(withAnnotations(state, { openWorldHint: true }));
+		},
+		query() {
+			return this.readOnly().idempotent();
+		},
+		resettable() {
+			return this.destructive().idempotent();
+		},
+		asyncTask() {
+			return next(withState(state, { asyncTask: true }));
+		},
+		autocomplete(argName, handler) {
+			return next(withState(state, { autocompleteHandlers: {
+				...state.autocompleteHandlers,
+				[argName]: handler
+			} }));
+		},
+		outputSchema(schema) {
+			return next(withState(state, { outputSchema: schema }));
+		},
+		build() {
+			return buildTool(state);
+		}
+	};
+	if (tracker && !tracker.latest) tracker.latest = builder;
+	return builder;
+}
+/** Create a new tool definition with fluent builder API. */
+function tool(name, configure) {
+	const tracker = {};
+	const builder = createBuilder(createInitialState(name), tracker);
+	return (configure(builder) ?? tracker.latest ?? builder).build();
+}
+//#endregion
+export { tool as t };