chore: import upstream snapshot with attribution

apps/sim/tools/sharepoint/create_page.ts

@@ -0,0 +1,160 @@
+import { createLogger } from '@sim/logger'
+import type {
+  SharepointCreatePageResponse,
+  SharepointPage,
+  SharepointToolParams,
+} from '@/tools/sharepoint/types'
+import { escapeHtml, optionalTrim } from '@/tools/sharepoint/utils'
+import type { ToolConfig } from '@/tools/types'
+
+const logger = createLogger('SharePointCreatePage')
+
+export const createPageTool: ToolConfig<SharepointToolParams, SharepointCreatePageResponse> = {
+  id: 'sharepoint_create_page',
+  name: 'Create SharePoint Page',
+  description: 'Create a new page in a SharePoint site',
+  version: '1.0.0',
+
+  oauth: {
+    required: true,
+    provider: 'sharepoint',
+  },
+
+  params: {
+    accessToken: {
+      type: 'string',
+      required: true,
+      visibility: 'hidden',
+      description: 'The access token for the SharePoint API',
+    },
+    siteId: {
+      type: 'string',
+      required: false,
+      visibility: 'hidden',
+      description: 'The ID of the SharePoint site (internal use)',
+    },
+    siteSelector: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'Select the SharePoint site',
+    },
+    pageName: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The name of the page to create. Example: My-New-Page.aspx or Report-2024.aspx',
+    },
+    pageTitle: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'The title of the page (defaults to page name if not provided)',
+    },
+    pageContent: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'The content of the page',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      const siteId = optionalTrim(params.siteId) || optionalTrim(params.siteSelector) || 'root'
+      return `https://graph.microsoft.com/v1.0/sites/${encodeURIComponent(siteId)}/pages`
+    },
+    method: 'POST',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.accessToken}`,
+      'Content-Type': 'application/json',
+      Accept: 'application/json',
+    }),
+    body: (params) => {
+      const pageName = optionalTrim(params.pageName)
+      if (!pageName) {
+        throw new Error('Page name is required')
+      }
+
+      const pageTitle = optionalTrim(params.pageTitle) || pageName
+
+      const pageData: SharepointPage = {
+        '@odata.type': '#microsoft.graph.sitePage',
+        name: pageName,
+        title: pageTitle,
+        publishingState: {
+          level: 'draft',
+        },
+        pageLayout: 'article',
+      }
+
+      const pageContent = typeof params.pageContent === 'string' ? params.pageContent : undefined
+      if (pageContent) {
+        pageData.canvasLayout = {
+          horizontalSections: [
+            {
+              layout: 'oneColumn',
+              id: '1',
+              emphasis: 'none',
+              columns: [
+                {
+                  id: '1',
+                  width: 12,
+                  webparts: [
+                    {
+                      id: '6f9230af-2a98-4952-b205-9ede4f9ef548',
+                      innerHtml: `<p>${escapeHtml(pageContent)}</p>`,
+                    },
+                  ],
+                },
+              ],
+            },
+          ],
+        }
+      }
+
+      return pageData
+    },
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    logger.info('SharePoint page created successfully', {
+      pageId: data.id,
+      pageName: data.name,
+      pageTitle: data.title,
+    })
+
+    return {
+      success: true,
+      output: {
+        page: {
+          id: data.id,
+          name: data.name,
+          title: data.title || data.name,
+          webUrl: data.webUrl,
+          pageLayout: data.pageLayout,
+          createdDateTime: data.createdDateTime,
+          lastModifiedDateTime: data.lastModifiedDateTime,
+        },
+      },
+    }
+  },
+
+  outputs: {
+    page: {
+      type: 'object',
+      description: 'Created SharePoint page information',
+      properties: {
+        id: { type: 'string', description: 'The unique ID of the created page' },
+        name: { type: 'string', description: 'The name of the created page' },
+        title: { type: 'string', description: 'The title of the created page' },
+        webUrl: { type: 'string', description: 'The URL to access the page' },
+        pageLayout: { type: 'string', description: 'The layout type of the page' },
+        createdDateTime: { type: 'string', description: 'When the page was created' },
+        lastModifiedDateTime: { type: 'string', description: 'When the page was last modified' },
+      },
+    },
+  },
+}