chore: import upstream snapshot with attribution

apps/sim/tools/jupyter/create_file.ts

@@ -0,0 +1,119 @@
+import type { JupyterCreateFileParams, JupyterCreateFileResponse } from '@/tools/jupyter/types'
+import { encodeJupyterPath, parseJupyterContentModel } from '@/tools/jupyter/utils'
+import type { ToolConfig } from '@/tools/types'
+
+const EMPTY_NOTEBOOK = { cells: [], metadata: {}, nbformat: 4, nbformat_minor: 5 }
+
+export const jupyterCreateFileTool: ToolConfig<JupyterCreateFileParams, JupyterCreateFileResponse> =
+  {
+    id: 'jupyter_create_file',
+    name: 'Jupyter Create File',
+    description: 'Create a file, notebook, or directory on a Jupyter server',
+    version: '1.0.0',
+
+    params: {
+      serverUrl: {
+        type: 'string',
+        required: true,
+        visibility: 'user-only',
+        description: 'Base URL of the Jupyter server (e.g. http://localhost:8888)',
+      },
+      token: {
+        type: 'string',
+        required: true,
+        visibility: 'user-only',
+        description: 'Jupyter server authentication token',
+      },
+      path: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'Path to create, relative to the server root',
+      },
+      type: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'Type of entry to create: file, notebook, or directory',
+      },
+      content: {
+        type: 'string',
+        required: false,
+        visibility: 'user-or-llm',
+        description:
+          'Content to write. For a file, plain text. For a notebook, a JSON-stringified nbformat document (defaults to an empty notebook). Ignored for directories.',
+      },
+    },
+
+    request: {
+      url: '/api/tools/jupyter/proxy',
+      method: 'POST',
+      headers: () => ({ 'Content-Type': 'application/json' }),
+      body: (params) => {
+        let content: Record<string, unknown>
+        if (params.type === 'directory') {
+          content = { type: 'directory' }
+        } else if (params.type === 'notebook') {
+          if (!params.content) {
+            content = { type: 'notebook', format: 'json', content: EMPTY_NOTEBOOK }
+          } else {
+            let notebook: unknown
+            try {
+              notebook = JSON.parse(params.content)
+            } catch {
+              throw new Error('Notebook content must be valid JSON-stringified nbformat')
+            }
+            content = { type: 'notebook', format: 'json', content: notebook }
+          }
+        } else {
+          content = { type: 'file', format: 'text', content: params.content ?? '' }
+        }
+
+        return {
+          serverUrl: params.serverUrl,
+          token: params.token,
+          method: 'PUT',
+          path: `contents/${encodeJupyterPath(params.path)}`,
+          body: content,
+        }
+      },
+    },
+
+    transformResponse: async (response, params) => {
+      if (!response.ok) {
+        const errorText = await response.text()
+        return {
+          success: false,
+          error: `Jupyter API error: ${response.status} ${errorText}`,
+          output: {
+            name: '',
+            path: params?.path ?? '',
+            type: params?.type ?? 'file',
+            createdAt: null,
+            lastModified: null,
+          },
+        }
+      }
+
+      const data = parseJupyterContentModel(await response.json()) ?? {}
+
+      return {
+        success: true,
+        output: {
+          name: data.name ?? '',
+          path: data.path ?? params?.path ?? '',
+          type: data.type ?? 'file',
+          createdAt: data.created ?? null,
+          lastModified: data.lastModified ?? null,
+        },
+      }
+    },
+
+    outputs: {
+      name: { type: 'string', description: 'Created entry name' },
+      path: { type: 'string', description: 'Created entry path' },
+      type: { type: 'string', description: 'directory, file, or notebook' },
+      createdAt: { type: 'string', description: 'Creation timestamp', optional: true },
+      lastModified: { type: 'string', description: 'Last modified timestamp', optional: true },
+    },
+  }