modality-kit 0.0.0

package/README.md

@@ -0,0 +1,16 @@
+# `modality-kit`
+
+> TODO: description
+
+## Repository
+
+-   `GIT`
+    -   https://github.com/react-atomic/modality
+-   `NPM`
+    -   https://www.npmjs.com/package/modality-kit
+
+## Usage
+
+```
+
+```

package/dist/index.js

@@ -0,0 +1,61 @@
+// src/util_mcp_tools_converter.ts
+var setupAITools = (aiTools, mcpServer) => {
+  if (mcpServer) {
+    Object.entries(aiTools).forEach(([toolName, aiTool]) => {
+      let name = aiTool.name != null ? aiTool.name : toolName;
+      mcpServer.addTool({
+        ...aiTool,
+        name
+      });
+    });
+  }
+  return aiTools;
+};
+// src/util_response.ts
+function formatSuccessResponse(content, meta) {
+  return JSON.stringify({
+    success: true,
+    content,
+    meta
+  });
+}
+function formatErrorResponse(errorData, operation, meta) {
+  let errorResponse;
+  if (typeof errorData === "string") {
+    errorResponse = {
+      success: false,
+      error: errorData,
+      operation,
+      meta
+    };
+  } else if (errorData instanceof Error) {
+    errorResponse = {
+      success: false,
+      error: errorData.message,
+      operation,
+      meta
+    };
+  } else if (typeof errorData === "object" && errorData !== null && typeof errorData.message === "string") {
+    const errObj = errorData;
+    errorResponse = {
+      success: errObj.success || false,
+      error: errObj.message,
+      code: errObj.code,
+      operation: errObj.operation || operation,
+      meta
+    };
+  } else {
+    errorResponse = {
+      success: false,
+      error: "Unknown error",
+      operation,
+      meta
+    };
+  }
+  return JSON.stringify(errorResponse);
+}
+export {
+  setupAITools,
+  formatSuccessResponse,
+  formatErrorResponse
+};

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export { setupAITools } from "./util_mcp_tools_converter";
+export type { AITools, AITool } from "./schemas/schemas_tool_config";
+export { formatErrorResponse, formatSuccessResponse } from "./util_response";

package/dist/types/schemas/schemas_tool_config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * TypeScript interfaces for tool configuration objects
+ */
+/**
+ * Tool interface for AI SDK compatibility
+ */
+export interface AITool {
+    name?: string;
+    annotations?: any;
+    description: string;
+    parameters: any;
+    execute: (parameters: any, options?: any) => Promise<any>;
+}
+/**
+ * Type for a collection of AI tools
+ */
+export type AITools = Record<string, AITool>;

package/dist/types/util_mcp_tools_converter.d.ts

@@ -0,0 +1,9 @@
+import { FastMCP } from "fastmcp";
+import type { AITools } from "./schemas/schemas_tool_config.ts";
+/**
+ * Setup function that optionally registers AITools with MCP server
+ * @param aiTools - The AITools object to optionally register
+ * @param mcpServer - Optional MCP server to register tools with
+ * @returns The AITools object
+ */
+export declare const setupAITools: (aiTools: AITools, mcpServer?: FastMCP) => AITools;

package/dist/types/util_response.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Utility functions for formatting MCP responses
+ *
+ * This is a global utility module that should not import domain-specific classes.
+ * It provides generic response formatting for any MCP tool.
+ */
+export interface McpSuccessResponse {
+    success: true;
+    content: any;
+    meta?: any;
+}
+export interface McpErrorResponse {
+    success: boolean;
+    error: string;
+    code?: string;
+    operation?: string;
+    meta?: Record<string, any>;
+}
+interface SuccessData {
+    message: string;
+    [key: string]: any;
+}
+/**
+ * Generic error data interface for MCP error responses
+ */
+interface ErrorData {
+    success?: boolean;
+    message: string;
+    code?: string;
+    operation?: string;
+    [key: string]: any;
+}
+/**
+ * Format a successful response for MCP tools
+ */
+export declare function formatSuccessResponse(content: SuccessData, meta?: any): string;
+/**
+ * Format an error response for MCP tools using generic error data
+ */
+export declare function formatErrorResponse(errorData: ErrorData | Error | string | unknown, operation?: string, meta?: Record<string, any>): string;
+export {};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "version": "0.0.0",
+  "name": "modality-kit",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/react-atomic/modality"
+  },
+  "homepage": "https://github.com/react-atomic/modality/modality-kit",
+  "description": "TODO: description",
+  "keywords": [
+    "modality-kit"
+  ],
+  "author": "Hill <hill@kimo.com>",
+  "license": "ISC",
+  "dependencies": {
+  },
+  "devDependencies": {
+    "fastmcp": "^3.6.2"
+  },
+  "exports": {
+    "require": "./dist/index.js",
+    "types": "./dist/types/index.d.ts"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "scripts": {
+    "update-compile-sh": "yo reshow:compile-sh",
+    "build:types": "bunx tsc -p ./",
+    "build:src": "bun build src/index.ts --outdir dist",
+    "build": "bun run build:src && bun run build:types",
+    "test": "npm run build",
+    "prepublishOnly": "npm run test"
+  },
+  "types": "./dist/types/index.d.ts",
+  "files": [
+    "package.json",
+    "README.md",
+    "dist"
+  ]
+}