freestyle-sandboxes 0.0.1

package/dist/ai/index.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+var index = require('../index.cjs');
+var ai = require('ai');
+var zod = require('zod');
+require('@hey-api/client-fetch');
+
+const executeTool = (config) => {
+  const api = new index.FreestyleSandboxes({
+    apiKey: config.apiKey
+  });
+  return ai.tool({
+    description: "Execute a JavaScript or TypeScript script",
+    parameters: zod.z.object({
+      script: zod.z.string().describe(`
+            The JavaScript or TypeScript script to execute, must be in the format of:
+            
+            export default () => {
+               ... your code here ...
+               return output;
+            }
+
+            or for async functions:
+
+            export default async () => {
+                ... your code here ...
+                return output;
+            }
+            `)
+    }),
+    execute: async ({ script }) => {
+      return api.executeScript(script, config);
+    }
+  });
+};
+
+exports.executeTool = executeTool;

package/dist/ai/index.d.cts

@@ -0,0 +1,29 @@
+import * as ai from 'ai';
+import { F as FreestyleExecuteScriptParamsConfiguration, a as FreestyleExecureScriptResultSuccess } from '../types.gen-BoJEFWW-.js';
+import { z } from 'zod';
+
+/**
+ * Execute a JavaScript or TypeScript script
+ *
+ *  **Note: Unless you tell it, the AI won't be aware of any node_modules or environment variables you give it, you need to tell it in your prompt what it can use.**
+
+ *
+ * @param config - Configuration for the tool
+ * @param config.apiKey - The API key to use
+ *
+ */
+declare const executeTool: (config: FreestyleExecuteScriptParamsConfiguration & {
+    apiKey: string;
+}) => ai.CoreTool<z.ZodObject<{
+    script: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    script?: string;
+}, {
+    script?: string;
+}>, FreestyleExecureScriptResultSuccess> & {
+    execute: (args: {
+        script?: string;
+    }, options: ai.ToolExecutionOptions) => PromiseLike<FreestyleExecureScriptResultSuccess>;
+};
+
+export { executeTool };

package/dist/ai/index.d.mts

@@ -0,0 +1,29 @@
+import * as ai from 'ai';
+import { F as FreestyleExecuteScriptParamsConfiguration, a as FreestyleExecureScriptResultSuccess } from '../types.gen-BoJEFWW-.js';
+import { z } from 'zod';
+
+/**
+ * Execute a JavaScript or TypeScript script
+ *
+ *  **Note: Unless you tell it, the AI won't be aware of any node_modules or environment variables you give it, you need to tell it in your prompt what it can use.**
+
+ *
+ * @param config - Configuration for the tool
+ * @param config.apiKey - The API key to use
+ *
+ */
+declare const executeTool: (config: FreestyleExecuteScriptParamsConfiguration & {
+    apiKey: string;
+}) => ai.CoreTool<z.ZodObject<{
+    script: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    script?: string;
+}, {
+    script?: string;
+}>, FreestyleExecureScriptResultSuccess> & {
+    execute: (args: {
+        script?: string;
+    }, options: ai.ToolExecutionOptions) => PromiseLike<FreestyleExecureScriptResultSuccess>;
+};
+
+export { executeTool };

package/dist/ai/index.mjs

@@ -0,0 +1,35 @@
+import { FreestyleSandboxes } from '../index.mjs';
+import { tool } from 'ai';
+import { z } from 'zod';
+import '@hey-api/client-fetch';
+
+const executeTool = (config) => {
+  const api = new FreestyleSandboxes({
+    apiKey: config.apiKey
+  });
+  return tool({
+    description: "Execute a JavaScript or TypeScript script",
+    parameters: z.object({
+      script: z.string().describe(`
+            The JavaScript or TypeScript script to execute, must be in the format of:
+            
+            export default () => {
+               ... your code here ...
+               return output;
+            }
+
+            or for async functions:
+
+            export default async () => {
+                ... your code here ...
+                return output;
+            }
+            `)
+    }),
+    execute: async ({ script }) => {
+      return api.executeScript(script, config);
+    }
+  });
+};
+
+export { executeTool };

package/dist/index.cjs

@@ -0,0 +1,135 @@
+'use strict';
+
+var clientFetch = require('@hey-api/client-fetch');
+
+const client = clientFetch.createClient(clientFetch.createConfig());
+const handleDeployCloudstate = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/cloudstate/v1/deploy"
+  });
+};
+const handleBackupCloudstate = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/cloudstate/v1/projects/:id/backup"
+  });
+};
+const handleExecuteScript = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/execute/v1/script"
+  });
+};
+const handleDeployWeb = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/web/v1/deploy"
+  });
+};
+const handleGetLogs = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/web/v1/projects/:id/logs"
+  });
+};
+
+class FreestyleSandboxes {
+  client;
+  constructor(options) {
+    this.client = clientFetch.createClient({
+      baseUrl: options.baseUrl ?? "https://api.freestyle.sh",
+      headers: {
+        Authorization: `Bearer ${options.apiKey}`
+      }
+    });
+  }
+  /**
+   * Execute a script in a sandbox.
+   */
+  async executeScript(script, config) {
+    const response = await handleExecuteScript({
+      client: this.client,
+      body: {
+        script,
+        config
+      }
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to execute script");
+    }
+  }
+  /**
+   * Deploy a Web project to a sandbox.
+   */
+  async deployWeb(files, config) {
+    const response = await handleDeployWeb({
+      client: this.client,
+      body: {
+        files,
+        config
+      }
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to deploy Web project");
+    }
+  }
+  /**
+   * Deploy a Cloudstate project to a sandbox.
+   */
+  async deployCloudstate(body) {
+    const response = await handleDeployCloudstate({
+      client: this.client,
+      body
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to deploy Cloudstate project");
+    }
+  }
+  /**
+   * Get a backup of a Cloudstate project in a sandbox.
+   * @param id The ID of the Cloudstate project.
+   * @returns The backup of the Cloudstate project.
+   * @throws An error if the backup could not be retrieved.
+   */
+  async backupCloudstate(id) {
+    const response = await handleBackupCloudstate({
+      client: this.client,
+      path: {
+        id
+      }
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to get backup of Cloudstate project");
+    }
+  }
+  /**
+   * Get logs for a sandbox.
+   * @param id The ID of the sandbox.
+   * @returns The logs for the sandbox.
+   * @throws An error if the logs could not be retrieved.
+   */
+  async getLogs(id) {
+    const response = await handleGetLogs({
+      client: this.client,
+      path: {
+        id
+      }
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to get logs for sandbox");
+    }
+  }
+}
+
+exports.FreestyleSandboxes = FreestyleSandboxes;

package/dist/index.d.cts

@@ -0,0 +1,43 @@
+import { F as FreestyleExecuteScriptParamsConfiguration, a as FreestyleExecureScriptResultSuccess, b as FreestyleDeployWebConfiguration, c as FreestyleDeployWebSuccessResponse, d as FreestyleCloudstateDeployRequest, e as FreestyleCloudstateDeploySuccessResponse, H as HandleBackupCloudstateResponse, f as HandleGetLogsResponse } from './types.gen-BoJEFWW-.js';
+
+declare class FreestyleSandboxes {
+    private client;
+    constructor(options: {
+        /**
+         * The base URL for the API.
+         */
+        baseUrl?: string;
+        /**
+         * The API key to use for requests.
+         */
+        apiKey: string;
+    });
+    /**
+     * Execute a script in a sandbox.
+     */
+    executeScript(script: string, config: FreestyleExecuteScriptParamsConfiguration): Promise<FreestyleExecureScriptResultSuccess>;
+    /**
+     * Deploy a Web project to a sandbox.
+     */
+    deployWeb(files: Record<string, string>, config: FreestyleDeployWebConfiguration): Promise<FreestyleDeployWebSuccessResponse>;
+    /**
+     * Deploy a Cloudstate project to a sandbox.
+     */
+    deployCloudstate(body: FreestyleCloudstateDeployRequest): Promise<FreestyleCloudstateDeploySuccessResponse>;
+    /**
+     * Get a backup of a Cloudstate project in a sandbox.
+     * @param id The ID of the Cloudstate project.
+     * @returns The backup of the Cloudstate project.
+     * @throws An error if the backup could not be retrieved.
+     */
+    backupCloudstate(id: string): Promise<HandleBackupCloudstateResponse>;
+    /**
+     * Get logs for a sandbox.
+     * @param id The ID of the sandbox.
+     * @returns The logs for the sandbox.
+     * @throws An error if the logs could not be retrieved.
+     */
+    getLogs(id: string): Promise<HandleGetLogsResponse>;
+}
+
+export { FreestyleSandboxes };

package/dist/index.d.mts

@@ -0,0 +1,43 @@
+import { F as FreestyleExecuteScriptParamsConfiguration, a as FreestyleExecureScriptResultSuccess, b as FreestyleDeployWebConfiguration, c as FreestyleDeployWebSuccessResponse, d as FreestyleCloudstateDeployRequest, e as FreestyleCloudstateDeploySuccessResponse, H as HandleBackupCloudstateResponse, f as HandleGetLogsResponse } from './types.gen-BoJEFWW-.js';
+
+declare class FreestyleSandboxes {
+    private client;
+    constructor(options: {
+        /**
+         * The base URL for the API.
+         */
+        baseUrl?: string;
+        /**
+         * The API key to use for requests.
+         */
+        apiKey: string;
+    });
+    /**
+     * Execute a script in a sandbox.
+     */
+    executeScript(script: string, config: FreestyleExecuteScriptParamsConfiguration): Promise<FreestyleExecureScriptResultSuccess>;
+    /**
+     * Deploy a Web project to a sandbox.
+     */
+    deployWeb(files: Record<string, string>, config: FreestyleDeployWebConfiguration): Promise<FreestyleDeployWebSuccessResponse>;
+    /**
+     * Deploy a Cloudstate project to a sandbox.
+     */
+    deployCloudstate(body: FreestyleCloudstateDeployRequest): Promise<FreestyleCloudstateDeploySuccessResponse>;
+    /**
+     * Get a backup of a Cloudstate project in a sandbox.
+     * @param id The ID of the Cloudstate project.
+     * @returns The backup of the Cloudstate project.
+     * @throws An error if the backup could not be retrieved.
+     */
+    backupCloudstate(id: string): Promise<HandleBackupCloudstateResponse>;
+    /**
+     * Get logs for a sandbox.
+     * @param id The ID of the sandbox.
+     * @returns The logs for the sandbox.
+     * @throws An error if the logs could not be retrieved.
+     */
+    getLogs(id: string): Promise<HandleGetLogsResponse>;
+}
+
+export { FreestyleSandboxes };

package/dist/index.mjs

@@ -0,0 +1,133 @@
+import { createClient, createConfig } from '@hey-api/client-fetch';
+
+const client = createClient(createConfig());
+const handleDeployCloudstate = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/cloudstate/v1/deploy"
+  });
+};
+const handleBackupCloudstate = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/cloudstate/v1/projects/:id/backup"
+  });
+};
+const handleExecuteScript = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/execute/v1/script"
+  });
+};
+const handleDeployWeb = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/web/v1/deploy"
+  });
+};
+const handleGetLogs = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/web/v1/projects/:id/logs"
+  });
+};
+
+class FreestyleSandboxes {
+  client;
+  constructor(options) {
+    this.client = createClient({
+      baseUrl: options.baseUrl ?? "https://api.freestyle.sh",
+      headers: {
+        Authorization: `Bearer ${options.apiKey}`
+      }
+    });
+  }
+  /**
+   * Execute a script in a sandbox.
+   */
+  async executeScript(script, config) {
+    const response = await handleExecuteScript({
+      client: this.client,
+      body: {
+        script,
+        config
+      }
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to execute script");
+    }
+  }
+  /**
+   * Deploy a Web project to a sandbox.
+   */
+  async deployWeb(files, config) {
+    const response = await handleDeployWeb({
+      client: this.client,
+      body: {
+        files,
+        config
+      }
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to deploy Web project");
+    }
+  }
+  /**
+   * Deploy a Cloudstate project to a sandbox.
+   */
+  async deployCloudstate(body) {
+    const response = await handleDeployCloudstate({
+      client: this.client,
+      body
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to deploy Cloudstate project");
+    }
+  }
+  /**
+   * Get a backup of a Cloudstate project in a sandbox.
+   * @param id The ID of the Cloudstate project.
+   * @returns The backup of the Cloudstate project.
+   * @throws An error if the backup could not be retrieved.
+   */
+  async backupCloudstate(id) {
+    const response = await handleBackupCloudstate({
+      client: this.client,
+      path: {
+        id
+      }
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to get backup of Cloudstate project");
+    }
+  }
+  /**
+   * Get logs for a sandbox.
+   * @param id The ID of the sandbox.
+   * @returns The logs for the sandbox.
+   * @throws An error if the logs could not be retrieved.
+   */
+  async getLogs(id) {
+    const response = await handleGetLogs({
+      client: this.client,
+      path: {
+        id
+      }
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to get logs for sandbox");
+    }
+  }
+}
+
+export { FreestyleSandboxes };

package/dist/types.gen-BoJEFWW-.d.ts

@@ -0,0 +1,84 @@
+type FreestyleCloudstateDeployConfiguration = {
+    /**
+     * ID of the project to deploy, if not provided will create a new project
+     */
+    projectId?: (string) | null;
+    /**
+     * The environment variables that the cloudstate deploy can access
+     */
+    envVars?: {
+        [key: string]: (string);
+    };
+};
+type FreestyleCloudstateDeployRequest = {
+    classes: string;
+    config?: FreestyleCloudstateDeployConfiguration;
+};
+type FreestyleCloudstateDeploySuccessResponse = {
+    /**
+     * The id of the project deployed to
+     */
+    projectId: string;
+};
+type FreestyleDeployWebConfiguration = {
+    /**
+     * The entrypoint file for the website
+     */
+    entrypoint?: (string) | null;
+    /**
+     * The custom domains for the website, eg. [\"subdomain.yourwebsite.com\"]. You may not include *.style.dev domains here, those are reserved for projectIds
+     */
+    domains?: Array<(string)> | null;
+    /**
+     * The project id to deploy to, if not provided will create a new project, may be used to provision a new project with a specific id if that id is available
+     */
+    projectId?: (string) | null;
+    /**
+     * Node Modules to install for the website, a map of package names to versions, e.g. { \"express\": \"4.17.1\" }. If this and a package-lock.json are provided, the package-lock.json, bun.lockb, pnpm-lock.yaml, or yarn.lock is also provided, the versions here will override the versions in those lock files.
+     */
+    nodeModules?: {
+        [key: string]: (string);
+    } | null;
+    /**
+     * The environment variables that the website can access
+     * e.g. { \"RESEND_API_KEY\": \"re_123456789\" }
+     */
+    envVars?: {
+        [key: string]: (string);
+    } | null;
+};
+type FreestyleDeployWebSuccessResponse = {
+    projectId: string;
+};
+type FreestyleExecureScriptResultSuccess = {
+    result: unknown;
+};
+type FreestyleExecuteScriptParamsConfiguration = {
+    /**
+     * The environment variables to set for the script
+     */
+    envVars?: {
+        [key: string]: (string);
+    };
+    /**
+     * The node modules to install for the script
+     */
+    nodeModules?: {
+        [key: string]: (string);
+    };
+    /**
+     * Tags for you to organize your scripts, useful for tracking what you're running
+     */
+    tags?: Array<(string)>;
+    /**
+     * The script timeout
+     */
+    timeout?: (string) | null;
+};
+type FreestyleLogResponseObject = {
+    message: string;
+};
+type HandleBackupCloudstateResponse = (Array<(number)>);
+type HandleGetLogsResponse = (Array<FreestyleLogResponseObject>);
+
+export type { FreestyleExecuteScriptParamsConfiguration as F, HandleBackupCloudstateResponse as H, FreestyleExecureScriptResultSuccess as a, FreestyleDeployWebConfiguration as b, FreestyleDeployWebSuccessResponse as c, FreestyleCloudstateDeployRequest as d, FreestyleCloudstateDeploySuccessResponse as e, HandleGetLogsResponse as f };

package/openapi/index.ts

@@ -0,0 +1,3 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export * from './sdk.gen';
+export * from './types.gen';

package/openapi/sdk.gen.ts

@@ -0,0 +1,61 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+import { createClient, createConfig, type OptionsLegacyParser } from '@hey-api/client-fetch';
+import type { HandleDeployCloudstateData, HandleDeployCloudstateError, HandleDeployCloudstateResponse, HandleBackupCloudstateError, HandleBackupCloudstateResponse, HandleExecuteScriptData, HandleExecuteScriptError, HandleExecuteScriptResponse, HandleDeployWebData, HandleDeployWebError, HandleDeployWebResponse, HandleGetLogsError, HandleGetLogsResponse } from './types.gen';
+
+export const client = createClient(createConfig());
+
+/**
+ * Deploy Cloudstate Project
+ * Deploy a cloudstate project
+ */
+export const handleDeployCloudstate = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<HandleDeployCloudstateData, ThrowOnError>) => {
+    return (options?.client ?? client).post<HandleDeployCloudstateResponse, HandleDeployCloudstateError, ThrowOnError>({
+        ...options,
+        url: '/cloudstate/v1/deploy'
+    });
+};
+
+/**
+ * Get Backup of Cloudstate Project
+ * Get a backup of a cloudstate project
+ */
+export const handleBackupCloudstate = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => {
+    return (options?.client ?? client).get<HandleBackupCloudstateResponse, HandleBackupCloudstateError, ThrowOnError>({
+        ...options,
+        url: '/cloudstate/v1/projects/:id/backup'
+    });
+};
+
+/**
+ * Execute Code
+ * Send a TypeScript or JavaScript module, get the result
+ */
+export const handleExecuteScript = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<HandleExecuteScriptData, ThrowOnError>) => {
+    return (options?.client ?? client).post<HandleExecuteScriptResponse, HandleExecuteScriptError, ThrowOnError>({
+        ...options,
+        url: '/execute/v1/script'
+    });
+};
+
+/**
+ * Deploy a Website
+ * Deploy a website. Files is a map of file paths to file contents. Configuration is optional and contains additional information about the deployment.
+ */
+export const handleDeployWeb = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<HandleDeployWebData, ThrowOnError>) => {
+    return (options?.client ?? client).post<HandleDeployWebResponse, HandleDeployWebError, ThrowOnError>({
+        ...options,
+        url: '/web/v1/deploy'
+    });
+};
+
+/**
+ * Get Website Logs
+ * Get the logs for a project
+ */
+export const handleGetLogs = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => {
+    return (options?.client ?? client).get<HandleGetLogsResponse, HandleGetLogsError, ThrowOnError>({
+        ...options,
+        url: '/web/v1/projects/:id/logs'
+    });
+};

package/openapi/types.gen.ts

@@ -0,0 +1,153 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+export type FreestyleCloudstateDeployConfiguration = {
+    /**
+     * ID of the project to deploy, if not provided will create a new project
+     */
+    projectId?: (string) | null;
+    /**
+     * The environment variables that the cloudstate deploy can access
+     */
+    envVars?: {
+        [key: string]: (string);
+    };
+};
+
+export type FreestyleCloudstateDeployErrorResponse = {
+    message: string;
+};
+
+export type FreestyleCloudstateDeployRequest = {
+    classes: string;
+    config?: FreestyleCloudstateDeployConfiguration;
+};
+
+export type FreestyleCloudstateDeploySuccessResponse = {
+    /**
+     * The id of the project deployed to
+     */
+    projectId: string;
+};
+
+export type FreestyleDeployWebConfiguration = {
+    /**
+     * The entrypoint file for the website
+     */
+    entrypoint?: (string) | null;
+    /**
+     * The custom domains for the website, eg. [\"subdomain.yourwebsite.com\"]. You may not include *.style.dev domains here, those are reserved for projectIds
+     */
+    domains?: Array<(string)> | null;
+    /**
+     * The project id to deploy to, if not provided will create a new project, may be used to provision a new project with a specific id if that id is available
+     */
+    projectId?: (string) | null;
+    /**
+     * Node Modules to install for the website, a map of package names to versions, e.g. { \"express\": \"4.17.1\" }. If this and a package-lock.json are provided, the package-lock.json, bun.lockb, pnpm-lock.yaml, or yarn.lock is also provided, the versions here will override the versions in those lock files.
+     */
+    nodeModules?: {
+        [key: string]: (string);
+    } | null;
+    /**
+     * The environment variables that the website can access
+     * e.g. { \"RESEND_API_KEY\": \"re_123456789\" }
+     */
+    envVars?: {
+        [key: string]: (string);
+    } | null;
+};
+
+export type FreestyleDeployWebErrorResponse = {
+    message: string;
+};
+
+export type FreestyleDeployWebPayload = {
+    /**
+     * The files to deploy, a map of file paths to file contents, e.g. { \"index.js\": \"your main", \"file2.js\": \"your helper\" }
+     *
+     * **Do not include node modules in this bundle, they will not work**. Instead, includes a package-lock.json, bun.lockb, pnpm-lock.yaml, or yarn.lock, the node modules for the project will be installed from that lock file, or use the node_modules field in the configuration to specify the node modules to install.
+     */
+    files: {
+        [key: string]: (string);
+    };
+    config?: FreestyleDeployWebConfiguration;
+};
+
+export type FreestyleDeployWebSuccessResponse = {
+    projectId: string;
+};
+
+export type FreestyleExecureScriptResultError = {
+    error: string;
+};
+
+export type FreestyleExecureScriptResultSuccess = {
+    result: unknown;
+};
+
+export type FreestyleExecuteScriptParams = {
+    /**
+     * The JavaScript or TypeScript script to execute
+     */
+    script: string;
+    config?: FreestyleExecuteScriptParamsConfiguration;
+};
+
+export type FreestyleExecuteScriptParamsConfiguration = {
+    /**
+     * The environment variables to set for the script
+     */
+    envVars?: {
+        [key: string]: (string);
+    };
+    /**
+     * The node modules to install for the script
+     */
+    nodeModules?: {
+        [key: string]: (string);
+    };
+    /**
+     * Tags for you to organize your scripts, useful for tracking what you're running
+     */
+    tags?: Array<(string)>;
+    /**
+     * The script timeout
+     */
+    timeout?: (string) | null;
+};
+
+export type FreestyleLogResponseObject = {
+    message: string;
+};
+
+export type HandleDeployCloudstateData = {
+    body: FreestyleCloudstateDeployRequest;
+};
+
+export type HandleDeployCloudstateResponse = (FreestyleCloudstateDeploySuccessResponse);
+
+export type HandleDeployCloudstateError = (FreestyleCloudstateDeployErrorResponse);
+
+export type HandleBackupCloudstateResponse = (Array<(number)>);
+
+export type HandleBackupCloudstateError = (unknown);
+
+export type HandleExecuteScriptData = {
+    body: FreestyleExecuteScriptParams;
+};
+
+export type HandleExecuteScriptResponse = (FreestyleExecureScriptResultSuccess);
+
+export type HandleExecuteScriptError = (FreestyleExecureScriptResultError);
+
+export type HandleDeployWebData = {
+    body: FreestyleDeployWebPayload;
+};
+
+export type HandleDeployWebResponse = (FreestyleDeployWebSuccessResponse);
+
+export type HandleDeployWebError = (FreestyleDeployWebErrorResponse);
+
+export type HandleGetLogsResponse = (Array<FreestyleLogResponseObject>);
+
+export type HandleGetLogsError = unknown;

package/openapi-ts.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "@hey-api/openapi-ts";
+
+export default defineConfig({
+  client: "@hey-api/client-fetch",
+  input: "./openapi.json",
+  output: "openapi/",
+});

package/openapi.json

@@ -0,0 +1 @@
+{"openapi":"3.1.0","info":{"title":"Freestyle Sandoxes","description":"\nFreestyle Sandboxes lets you deploy your users or AIs code.\n        \nThey are broken up into 3 categories: [Web](#tag/web), [Execute](#tag/execute) and [Cloudstate](#tag/cloudstate).\n\n[Web](#tag/web): Send us the code for the website, we'll provision the certificates and get it hosted\n\n[Execute](#tag/execute): Send us a function, we'll run it and send you the output\n\n[Cloudstate](#tag/cloudstate): Our Opensource JavaScript Runtime used for cloud functions with persistent state\n","contact":{"name":"Ben","email":"ben@freestyle.sh"},"license":{"name":""},"version":"0.1.0"},"servers":[{"url":"https://api.freestyle.sh","description":"Production"}],"paths":{"/cloudstate/v1/deploy":{"post":{"tags":["Cloudstate"],"summary":"Deploy Cloudstate Project","description":"Deploy a cloudstate project","operationId":"handle_deploy_cloudstate","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreestyleCloudstateDeployRequest"}}},"required":true},"responses":{"200":{"description":"successfully deployed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreestyleCloudstateDeploySuccessResponse"}}}},"500":{"description":"failed to deploy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreestyleCloudstateDeployErrorResponse"}}}}}}},"/cloudstate/v1/projects/:id/backup":{"get":{"tags":["Cloudstate"],"summary":"Get Backup of Cloudstate Project","description":"Get a backup of a cloudstate project","operationId":"handle_backup_cloudstate","responses":{"200":{"description":"successfully backed up","content":{"application/octet-stream":{"schema":{"type":"array","items":{"type":"integer","format":"int32","minimum":0}}}}},"500":{"description":"failed to backup"}}}},"/execute/v1/script":{"post":{"tags":["Execute"],"summary":"Execute Code","description":"Send a TypeScript or JavaScript module, get the result","operationId":"handle_execute_script","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreestyleExecuteScriptParams"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreestyleExecureScriptResultSuccess"}}}},"400":{"description":"Error in your Script","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreestyleExecureScriptResultError"}}}},"500":{"description":"Internal Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreestyleExecureScriptResultError"}}}}}}},"/web/v1/deploy":{"post":{"tags":["Web"],"summary":"Deploy a Website","description":"Deploy a website. Files is a map of file paths to file contents. Configuration is optional and contains additional information about the deployment.","operationId":"handle_deploy_web","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreestyleDeployWebPayload"}}},"required":true},"responses":{"200":{"description":"successfully deployed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreestyleDeployWebSuccessResponse"}}}},"400":{"description":"failed to deploy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreestyleDeployWebErrorResponse"}}}}}}},"/web/v1/projects/:id/logs":{"get":{"tags":["Web"],"summary":"Get Website Logs","description":"Get the logs for a project","operationId":"handle_get_logs","responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FreestyleLogResponseObject"}}}}}}}}},"components":{"schemas":{"FreestyleCloudstateDeployConfiguration":{"type":"object","properties":{"projectId":{"type":["string","null"],"description":"ID of the project to deploy, if not provided will create a new project","default":null},"envVars":{"type":"object","description":"The environment variables that the cloudstate deploy can access","default":{},"additionalProperties":{"type":"string"},"propertyNames":{"type":"string"}}}},"FreestyleCloudstateDeployErrorResponse":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}},"FreestyleCloudstateDeployRequest":{"type":"object","required":["classes"],"properties":{"classes":{"type":"string"},"config":{"$ref":"#/components/schemas/FreestyleCloudstateDeployConfiguration"}}},"FreestyleCloudstateDeploySuccessResponse":{"type":"object","required":["projectId"],"properties":{"projectId":{"type":"string","description":"The id of the project deployed to"}}},"FreestyleDeployWebConfiguration":{"type":"object","properties":{"entrypoint":{"type":["string","null"],"description":"The entrypoint file for the website","default":"index.js"},"domains":{"type":["array","null"],"items":{"type":"string"},"description":"The custom domains for the website, eg. [\\\"subdomain.yourwebsite.com\\\"]. You may not include *.style.dev domains here, those are reserved for projectIds","example":["subdomain.yourdomain.com"],"default":null},"projectId":{"type":["string","null"],"description":"The project id to deploy to, if not provided will create a new project, may be used to provision a new project with a specific id if that id is available","default":null},"nodeModules":{"type":["object","null"],"description":"Node Modules to install for the website, a map of package names to versions, e.g. { \\\"express\\\": \\\"4.17.1\\\" }. If this and a package-lock.json are provided, the package-lock.json, bun.lockb, pnpm-lock.yaml, or yarn.lock is also provided, the versions here will override the versions in those lock files.","default":null,"additionalProperties":{"type":"string"},"propertyNames":{"type":"string"},"example":{"resend":"4.0.1"}},"envVars":{"type":["object","null"],"description":"The environment variables that the website can access\ne.g. { \\\"RESEND_API_KEY\\\": \\\"re_123456789\\\" }","default":null,"additionalProperties":{"type":"string"},"propertyNames":{"type":"string"},"example":{"RESEND_API_KEY":"re_123456789"}}}},"FreestyleDeployWebErrorResponse":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}},"FreestyleDeployWebPayload":{"type":"object","required":["files"],"properties":{"files":{"type":"object","description":"The files to deploy, a map of file paths to file contents, e.g. { \\\"index.js\\\": \\\"your main\", \\\"file2.js\\\": \\\"your helper\\\" }\n\n**Do not include node modules in this bundle, they will not work**. Instead, includes a package-lock.json, bun.lockb, pnpm-lock.yaml, or yarn.lock, the node modules for the project will be installed from that lock file, or use the node_modules field in the configuration to specify the node modules to install.","additionalProperties":{"type":"string"},"propertyNames":{"type":"string"},"example":{"index.js":"import http from 'node:http';\\n// import { resolver } from './file2.js';\\n\\nconsole.log('starting server');\\n\\nconst server = http.createServer(async(req, res) => {\\n  // wait 5 seconds before responding\\n  // await new Promise((resolve) => setTimeout(resolve, 5000));\\n  res.writeHead(200, { 'Content-Type': 'text/plain' });\\n  res.end('Welcome to New York its been waiting for you');\\n});\\n\\nserver.listen(3000, () => {\\n  console.log('Server is running at http://localhost:3000');\\n});"}},"config":{"$ref":"#/components/schemas/FreestyleDeployWebConfiguration"}}},"FreestyleDeployWebSuccessResponse":{"type":"object","required":["projectId"],"properties":{"projectId":{"type":"string"}}},"FreestyleExecureScriptResultError":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}},"FreestyleExecureScriptResultSuccess":{"type":"object","required":["result"],"properties":{"result":{}}},"FreestyleExecuteScriptParams":{"type":"object","required":["script"],"properties":{"script":{"type":"string","description":"The JavaScript or TypeScript script to execute","example":"export default () => {\n  // get the value of the factorials of the numbers from 1 to 10 combined\n  const a = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];\n\n  function factorial(n) {\n    if (n === 0) {\n      return 1;\n    }\n    return n * factorial(n - 1);\n  }\n\n  const b = a.map(factorial);\n\n  return b.reduce((a, b) => a + b);\n};\n"},"config":{"$ref":"#/components/schemas/FreestyleExecuteScriptParamsConfiguration"}}},"FreestyleExecuteScriptParamsConfiguration":{"type":"object","properties":{"envVars":{"type":"object","description":"The environment variables to set for the script","default":{},"additionalProperties":{"type":"string"},"propertyNames":{"type":"string"},"example":{"RESEND_API_KEY":"re_123456789"}},"nodeModules":{"type":"object","description":"The node modules to install for the script","default":{},"additionalProperties":{"type":"string"},"propertyNames":{"type":"string"},"example":{"resend":"4.0.1"}},"tags":{"type":"array","items":{"type":"string"},"description":"Tags for you to organize your scripts, useful for tracking what you're running","example":["email"],"default":[]},"timeout":{"type":["string","null"],"description":"The script timeout","default":null}}},"FreestyleLogResponseObject":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"tags":[{"name":"Web","description":"APIs for deploying websites. We handle node modules caching, scaling, certificates and the whole end to end process. Send the code using the [deploy](#tag/web/POST/web/v1/deploy) endpoint, and you'll get a full hosted website back. Works with any TypeScript or JavaScript codebase."},{"name":"Execute","description":"APIs for running code. Send the code using the [execute](#tag/execute/POST/execute/v1/execute) endpoint, and you'll get the output back. Works with any TypeScript or JavaScript code + handles any node modules and environment variables you want."},{"name":"Cloudstate","description":"APIs for running cloud functions with persistent state. [Cloudstate](https://github.com/freestyle-sh/cloudstate/) is an opensource, durable JavaScript runtime maintained by the Freestyle Team."}]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "freestyle-sandboxes",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    },
+    "./ai": {
+      "require": {
+        "types": "./dist/ai/index.d.cts",
+        "default": "./dist/ai/index.cjs"
+      },
+      "import": {
+        "types": "./dist/ai/index.d.mts",
+        "default": "./dist/ai/index.mjs"
+      }
+    }
+  },
+  "scripts": {
+    "openapi": "openapi-ts",
+    "build": "pkgroll"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "devDependencies": {
+    "@hey-api/openapi-ts": "^0.60.1",
+    "pkgroll": "^2.6.0"
+  },
+  "dependencies": {
+    "@hey-api/client-fetch": "^0.5.7",
+    "ai": "^4.0.25",
+    "zod": "^3.24.1"
+  }
+}

package/src/ai/index.ts

@@ -0,0 +1,47 @@
+import { FreestyleExecuteScriptParamsConfiguration } from "../../openapi";
+import { FreestyleSandboxes } from "..";
+import { tool } from "ai";
+import { z } from "zod";
+
+/**
+ * Execute a JavaScript or TypeScript script
+ * 
+ *  **Note: Unless you tell it, the AI won't be aware of any node_modules or environment variables you give it, you need to tell it in your prompt what it can use.**
+
+ *
+ * @param config - Configuration for the tool
+ * @param config.apiKey - The API key to use
+ *
+ */
+export const executeTool = (
+  config: FreestyleExecuteScriptParamsConfiguration & {
+    apiKey: string;
+  }
+) => {
+  const api = new FreestyleSandboxes({
+    apiKey: config.apiKey,
+  });
+  return tool({
+    description: "Execute a JavaScript or TypeScript script",
+    parameters: z.object({
+      script: z.string().describe(`
+            The JavaScript or TypeScript script to execute, must be in the format of:
+            
+            export default () => {
+               ... your code here ...
+               return output;
+            }
+
+            or for async functions:
+
+            export default async () => {
+                ... your code here ...
+                return output;
+            }
+            `),
+    }),
+    execute: async ({ script }) => {
+      return api.executeScript(script, config);
+    },
+  });
+};

package/src/index.ts

@@ -0,0 +1,123 @@
+import { Client, createClient } from "@hey-api/client-fetch";
+import * as sandbox_openapi from "../openapi/index.ts";
+export class FreestyleSandboxes {
+  private client: Client;
+  constructor(options: {
+    /**
+     * The base URL for the API.
+     */
+    baseUrl?: string;
+    /**
+     * The API key to use for requests.
+     */
+    apiKey: string;
+  }) {
+    this.client = createClient({
+      baseUrl: options.baseUrl ?? "https://api.freestyle.sh",
+      headers: {
+        Authorization: `Bearer ${options.apiKey}`,
+      },
+    });
+  }
+
+  /**
+   * Execute a script in a sandbox.
+   */
+  async executeScript(
+    script: string,
+    config: sandbox_openapi.FreestyleExecuteScriptParamsConfiguration
+  ): Promise<sandbox_openapi.FreestyleExecureScriptResultSuccess> {
+    const response = await sandbox_openapi.handleExecuteScript({
+      client: this.client,
+      body: {
+        script,
+        config: config,
+      },
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to execute script");
+    }
+  }
+
+  /**
+   * Deploy a Web project to a sandbox.
+   */
+  async deployWeb(
+    files: Record<string, string>,
+    config: sandbox_openapi.FreestyleDeployWebConfiguration
+  ): Promise<sandbox_openapi.FreestyleDeployWebSuccessResponse> {
+    const response = await sandbox_openapi.handleDeployWeb({
+      client: this.client,
+      body: {
+        files,
+        config: config,
+      },
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to deploy Web project");
+    }
+  }
+
+  /**
+   * Deploy a Cloudstate project to a sandbox.
+   */
+  async deployCloudstate(
+    body: sandbox_openapi.FreestyleCloudstateDeployRequest
+  ): Promise<sandbox_openapi.FreestyleCloudstateDeploySuccessResponse> {
+    const response = await sandbox_openapi.handleDeployCloudstate({
+      client: this.client,
+      body: body,
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to deploy Cloudstate project");
+    }
+  }
+
+  /**
+   * Get a backup of a Cloudstate project in a sandbox.
+   * @param id The ID of the Cloudstate project.
+   * @returns The backup of the Cloudstate project.
+   * @throws An error if the backup could not be retrieved.
+   */
+  async backupCloudstate(
+    id: string
+  ): Promise<sandbox_openapi.HandleBackupCloudstateResponse> {
+    const response = await sandbox_openapi.handleBackupCloudstate({
+      client: this.client,
+      path: {
+        id: id,
+      },
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to get backup of Cloudstate project");
+    }
+  }
+
+  /**
+   * Get logs for a sandbox.
+   * @param id The ID of the sandbox.
+   * @returns The logs for the sandbox.
+   * @throws An error if the logs could not be retrieved.
+   */
+  async getLogs(id: string): Promise<sandbox_openapi.HandleGetLogsResponse> {
+    const response = await sandbox_openapi.handleGetLogs({
+      client: this.client,
+      path: {
+        id: id,
+      },
+    });
+    if (response.data) {
+      return response.data;
+    } else {
+      throw new Error("Failed to get logs for sandbox");
+    }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "compilerOptions": {
+    "allowImportingTsExtensions": true,
+    "lib": ["ESNext"]
+  }
+}