freestyle-sandboxes 0.0.68 → 0.0.69

package/dist/index.cjs

@@ -57,6 +57,42 @@ const handleEphemeralDevServer = (options) => {
     url: "/ephemeral/v1/dev-servers"
   });
 };
+const handleExecOnEphemeralDevServer = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/ephemeral/v1/dev-servers/exec"
+  });
+};
+const handleWriteFileFromEphemeralDevServer = (options) => {
+  return (options?.client ?? client).put({
+    ...options,
+    url: "/ephemeral/v1/dev-servers/files/{*filepath}"
+  });
+};
+const handleReadFileFromEphemeralDevServer = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/ephemeral/v1/dev-servers/files/{*filepath}"
+  });
+};
+const handleGitCommitPush = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/ephemeral/v1/dev-servers/git/commit-push"
+  });
+};
+const handleShutdownDevServer = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/ephemeral/v1/dev-servers/shutdown"
+  });
+};
+const handleDevServerStatus = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/ephemeral/v1/dev-servers/status"
+  });
+};
 const handleListExecuteRuns = (options) => {
   return (options?.client ?? client).get({
     ...options,
@@ -192,7 +228,17 @@ const handleListWebDeploys = (options) => {
 
 class FreestyleSandboxes {
   client;
+  options;
   constructor(options) {
+    this.options = options ?? {};
+    if (!options?.apiKey) {
+      this.options.apiKey = process.env.FREESTYLE_API_KEY;
+    }
+    if (!this.options.apiKey) {
+      throw new Error(
+        "No API key provided. Please set the FREESTYLE_API_KEY environment variable or configure apiKey when constructing FreestyleSandboxes."
+      );
+    }
     if (typeof Deno !== "undefined") {
       class FreestyleRequest extends Request {
         constructor(input, init) {
@@ -206,10 +252,10 @@ class FreestyleSandboxes {
       Request = FreestyleRequest;
     }
     this.client = clientFetch.createClient({
-      baseUrl: options.baseUrl ?? "https://api.freestyle.sh",
+      baseUrl: this.options?.baseUrl ?? "https://api.freestyle.sh",
       headers: {
-        Authorization: `Bearer ${options.apiKey}`,
-        ...options.headers
+        Authorization: `Bearer ${this.options.apiKey}`,
+        ...this.options?.headers
       }
     });
   }
@@ -797,7 +843,7 @@ ${response.error.message}`);
       );
     }
     if (response.data.isNew) {
-      const rId = options.repoId || options.repoUrl.split("/").at(-1);
+      const rId = options.repoId || options.repoUrl?.split("/").at(-1);
       await this.createGitTrigger({
         repoId: rId,
         action: {
@@ -815,17 +861,208 @@ ${response.error.message}`);
     if (!response.data) {
       throw new Error(`Failed to request dev server: ${response.error}`);
     }
+    const data = response.data;
+    const devServerInstance = {
+      repoId: options.repoId || options.repo || "",
+      kind: "repo"
+    };
+    const client = this.client;
+    const that = this;
     return {
-      ...response.data,
-      // @ts-ignore
-      mcpEphemeralUrl: response.data.mcpEphemeralUrl || response.data.url + "/mcp",
-      ephemeralUrl: response.data.ephemeralUrl ?? response.data.url,
-      codeServerUrl: (
-        // @ts-ignore
-        response.data.codeServerUrl ?? response.data.ephemeralUrl + "/__freestyle_code_server/?folder=/template"
-      )
+      isNew: data.isNew,
+      ephemeralUrl: data.ephemeralUrl ?? data.url,
+      mcpEphemeralUrl: data.mcpEphemeralUrl ?? data.url + "/mcp",
+      codeServerUrl: data.codeServerUrl ?? (data.ephemeralUrl ?? data.url) + "/__freestyle_code_server/?folder=/template",
+      async status() {
+        const response2 = await handleDevServerStatus({
+          client,
+          body: {
+            devServer: devServerInstance
+          }
+        });
+        if (response2.error) {
+          throw new Error(`Failed to get status: ${response2.error}`);
+        }
+        return {
+          installing: response2.data.installing,
+          devRunning: response2.data.devRunning
+        };
+      },
+      async commitAndPush(message) {
+        const response2 = await handleGitCommitPush({
+          client,
+          body: {
+            devServer: devServerInstance,
+            message
+          }
+        });
+        if (response2.error) {
+          throw new Error(`Failed to commit and push: ${response2.error}`);
+        }
+      },
+      async shutdown() {
+        const response2 = await handleShutdownDevServer({
+          client,
+          body: {
+            devServer: devServerInstance
+          }
+        });
+        if (response2.error) {
+          throw new Error(`Failed to shutdown dev server: ${response2.error}`);
+        }
+        return {
+          success: response2.data.success,
+          message: response2.data.message
+        };
+      },
+      fs: {
+        async ls(path = "") {
+          const response2 = await handleReadFileFromEphemeralDevServer({
+            client,
+            path: {
+              filepath: path
+            },
+            body: {
+              devServer: devServerInstance,
+              encoding: "utf-8"
+            }
+          });
+          if (response2.error) {
+            throw new Error(`Failed to list directory: ${response2.error}`);
+          }
+          if (!response2.data?.content) {
+            return [];
+          }
+          if (response2.data.content.kind === "directory") {
+            return response2.data.content.files;
+          }
+          return [];
+        },
+        async *watch() {
+          const response2 = await that.fetch(
+            "/ephemeral/v1/dev-servers/watch-files",
+            {
+              method: "POST",
+              body: JSON.stringify({
+                devServer: {
+                  repoId: devServerInstance.repoId,
+                  kind: devServerInstance.kind
+                }
+              })
+            }
+          );
+          if (!response2.ok) {
+            throw new Error(
+              `Failed to fetch stream: ${response2.status} ${response2.statusText}`
+            );
+          }
+          if (!response2.body) {
+            throw new Error("Failed to fetch stream: No response body");
+          }
+          const reader = response2.body.getReader();
+          const decoder = new TextDecoder("utf-8");
+          let buffer = "";
+          while (true) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            buffer += decoder.decode(value, { stream: true });
+            let newlineIndex;
+            while ((newlineIndex = buffer.indexOf("\n")) >= 0) {
+              const line = buffer.slice(0, newlineIndex).trim();
+              buffer = buffer.slice(newlineIndex + 1);
+              if (line) {
+                yield JSON.parse(line);
+              }
+            }
+          }
+          if (buffer.trim()) {
+            yield JSON.parse(buffer.trim());
+          }
+        },
+        async readFile(path, encoding = "utf-8") {
+          const response2 = await handleReadFileFromEphemeralDevServer({
+            client,
+            path: {
+              filepath: path
+            },
+            body: {
+              devServer: devServerInstance,
+              encoding
+            }
+          });
+          if (response2.error) {
+            throw new Error(`Failed to read file: ${response2.error}`);
+          }
+          if (!response2.data?.content || response2.data.content.kind !== "file") {
+            throw new Error(`Not a file or file not found: ${path}`);
+          }
+          return response2.data.content.content;
+        },
+        async writeFile(path, content, encoding = "utf-8") {
+          const contentStr = typeof content === "string" ? content : new TextDecoder(encoding).decode(content);
+          const response2 = await handleWriteFileFromEphemeralDevServer({
+            client,
+            path: {
+              filepath: path
+            },
+            body: {
+              devServer: devServerInstance,
+              content: contentStr,
+              encoding
+            }
+          });
+          if (response2.error) {
+            throw new Error(`Failed to write file: ${response2.error}`);
+          }
+        }
+      },
+      process: {
+        async exec(cmd, background = false) {
+          const response2 = await handleExecOnEphemeralDevServer(
+            {
+              client,
+              body: {
+                devServer: devServerInstance,
+                command: cmd,
+                background
+              }
+            }
+          );
+          if (response2.error) {
+            throw new Error(`Failed to execute command: ${response2.error}`);
+          }
+          return {
+            id: response2.data.id,
+            isNew: response2.data.isNew,
+            stdout: response2.data.stdout,
+            stderr: response2.data.stderr
+          };
+        }
+      }
     };
   }
+  fetch(path, init) {
+    const headers = new Headers(init?.headers);
+    for (const [key, value] of Object.entries(this.options.headers ?? {})) {
+      if (!headers.has(key)) {
+        headers.append(key, value);
+      }
+    }
+    if (!headers.has("Authorization")) {
+      headers.append("Authorization", `Bearer ${this.options.apiKey}`);
+    }
+    if (!headers.has("Content-Type")) {
+      headers.append("Content-Type", "application/json");
+    }
+    const url = new URL(
+      path,
+      this.options.baseUrl ?? "https://api.freestyle.sh"
+    );
+    return fetch(url, {
+      ...init ?? {},
+      headers
+    });
+  }
 }
 
 exports.FreestyleSandboxes = FreestyleSandboxes;

package/dist/index.d.cts

@@ -1,22 +1,100 @@
-import { F as FreestyleExecuteScriptParamsConfiguration, a as FreestyleExecuteScriptResultSuccess, D as DeploymentSource, b as FreestyleDeployWebConfiguration, c as FreestyleDeployWebSuccessResponseV2, d as FreestyleCloudstateDeployRequest, e as FreestyleCloudstateDeploySuccessResponse, H as HandleBackupCloudstateResponse, f as HandleGetLogsResponse, g as HandleCreateDomainVerificationResponse, h as HandleVerifyDomainResponse, i as HandleVerifyDomainError, j as HandleListDomainsResponse, k as HandleListDomainVerificationRequestsResponse, l as HandleDeleteDomainVerificationResponse, m as HandleListWebDeploysResponse, n as HandleListExecuteRunsResponse, o as HandleGetExecuteRunResponse, p as HandleVerifyWildcardResponse, C as CreateRepositoryResponseSuccess, q as HandleListRepositoriesResponse, r as HandleDeleteRepoResponse, G as GitIdentity, s as HandleDeleteIdentityResponse, A as AccessLevel, t as HandleGrantPermissionResponse, L as ListPermissionResponseSuccess, u as DescribePermissionResponseSuccess, v as CreatedToken, w as ListGitTokensResponseSuccess, x as HandleListGitTriggersResponse, y as GitTrigger, z as GitTriggerAction, B as HandleCreateGitTriggerResponse } from './types.gen-BbekD8Sd.js';
-export { J as AccessTokenInfo, I as AccessibleRepository, K as Behavior, M as BlobEncoding, N as BlobObject, O as CommitObject, P as CommitParent, Q as CommitTree, R as CreateDomainMappingRequest, S as CreateRecordParams, T as CreateRepoRequest, V as CreateRepoSource, U as CreateRepositoryRequest, X as CustomBuildOptions, E as DeploymentBuildOptions, Y as DeploymentLogEntry, _ as DeploymentState, $ as DevServer, a1 as DevServerRequest, a2 as DevServerStatusRequest, a3 as DnsRecord, a4 as DnsRecordData, a5 as DnsRecordKind, a6 as DomainVerificationRequest, a7 as ExecRequest, a8 as ExecuteLogEntry, a9 as ExecuteRunInfo, aa as ExecuteRunState, ab as FileReadContent, ad as FreestyleCloudstateDeployConfiguration, ae as FreestyleCloudstateDeployErrorResponse, af as FreestyleDeleteDomainVerificationRequest, ag as FreestyleDeployWebErrorResponse, ah as FreestyleDeployWebPayload, ai as FreestyleDeployWebPayloadV2, aj as FreestyleDomainVerificationRequest, ak as FreestyleExecuteScriptParams, al as FreestyleFile, am as FreestyleGetLogsResponse, an as FreestyleJavaScriptLog, ao as FreestyleLogResponseObject, ap as FreestyleNetworkPermission, ar as FreestyleVerifyDomainRequest, as as GitCommitPushRequest, at as GitRepositoryTrigger, aw as GrantPermissionRequest, aP as HandleBackupCloudstateData, aQ as HandleBackupCloudstateError, b9 as HandleCreateDomainVerificationData, ba as HandleCreateDomainVerificationError, b_ as HandleCreateGitTokenData, c0 as HandleCreateGitTokenError, b$ as HandleCreateGitTokenResponse, cp as HandleCreateGitTriggerData, cq as HandleCreateGitTriggerError, bG as HandleCreateIdentityError, bF as HandleCreateIdentityResponse, aU as HandleCreateRecordData, aW as HandleCreateRecordError, aV as HandleCreateRecordResponse, c6 as HandleCreateRepoData, c8 as HandleCreateRepoError, c7 as HandleCreateRepoResponse, b4 as HandleDeleteDomainMappingData, b6 as HandleDeleteDomainMappingError, b5 as HandleDeleteDomainMappingResponse, bb as HandleDeleteDomainVerificationData, bc as HandleDeleteDomainVerificationError, cr as HandleDeleteGitTriggerData, ct as HandleDeleteGitTriggerError, cs as HandleDeleteGitTriggerResponse, bH as HandleDeleteIdentityData, bI as HandleDeleteIdentityError, aX as HandleDeleteRecordData, aZ as HandleDeleteRecordError, aY as HandleDeleteRecordResponse, cl as HandleDeleteRepoData, cm as HandleDeleteRepoError, aM as HandleDeployCloudstateData, aO as HandleDeployCloudstateError, aN as HandleDeployCloudstateResponse, cw as HandleDeployWebData, cy as HandleDeployWebError, cx as HandleDeployWebResponse, cz as HandleDeployWebV2Data, cB as HandleDeployWebV2Error, cA as HandleDeployWebV2Response, bM as HandleDescribePermissionData, bO as HandleDescribePermissionError, bN as HandleDescribePermissionResponse, bs as HandleDevServerStatusData, bu as HandleDevServerStatusError, bt as HandleDevServerStatusResponse, bd as HandleEphemeralDevServerData, bf as HandleEphemeralDevServerError, be as HandleEphemeralDevServerResponse, bg as HandleExecOnEphemeralDevServerData, bi as HandleExecOnEphemeralDevServerError, bh as HandleExecOnEphemeralDevServerResponse, bz as HandleExecuteScriptData, bB as HandleExecuteScriptError, bA as HandleExecuteScriptResponse, c9 as HandleGetBlobData, cb as HandleGetBlobError, ca as HandleGetBlobResponse, cc as HandleGetCommitData, ce as HandleGetCommitError, cd as HandleGetCommitResponse, bx as HandleGetExecuteRunData, by as HandleGetExecuteRunError, cu as HandleGetLogsData, cv as HandleGetLogsError, cf as HandleGetTagData, ch as HandleGetTagError, cg as HandleGetTagResponse, ci as HandleGetTreeData, ck as HandleGetTreeError, cj as HandleGetTreeResponse, cE as HandleGetWebDeployDetailsData, bp as HandleGitCommitPushData, br as HandleGitCommitPushError, bq as HandleGitCommitPushResponse, bP as HandleGrantPermissionData, bQ as HandleGrantPermissionError, b1 as HandleInsertDomainMappingData, b3 as HandleInsertDomainMappingError, b2 as HandleInsertDomainMappingResponse, b7 as HandleListDomainVerificationRequestsError, b0 as HandleListDomainsError, bv as HandleListExecuteRunsData, bw as HandleListExecuteRunsError, bX as HandleListGitTokensData, bZ as HandleListGitTokensError, bY as HandleListGitTokensResponse, cn as HandleListGitTriggersData, co as HandleListGitTriggersError, bC as HandleListIdentitiesData, bE as HandleListIdentitiesError, bD as HandleListIdentitiesResponse, bJ as HandleListPermissionsData, bL as HandleListPermissionsError, bK as HandleListPermissionsResponse, aR as HandleListRecordsData, aT as HandleListRecordsError, aS as HandleListRecordsResponse, c4 as HandleListRepositoriesData, c5 as HandleListRepositoriesError, cC as HandleListWebDeploysData, cD as HandleListWebDeploysError, bm as HandleReadFileFromEphemeralDevServerData, bo as HandleReadFileFromEphemeralDevServerError, bn as HandleReadFileFromEphemeralDevServerResponse, c1 as HandleRevokeGitTokenData, c3 as HandleRevokeGitTokenError, c2 as HandleRevokeGitTokenResponse, bR as HandleRevokePermissionData, bT as HandleRevokePermissionError, bS as HandleRevokePermissionResponse, bU as HandleUpdatePermissionData, bW as HandleUpdatePermissionError, bV as HandleUpdatePermissionResponse, b8 as HandleVerifyDomainData, a_ as HandleVerifyWildcardData, a$ as HandleVerifyWildcardError, bj as HandleWriteFileFromEphemeralDevServerData, bl as HandleWriteFileFromEphemeralDevServerError, bk as HandleWriteFileFromEphemeralDevServerResponse, ax as InternalServerError, ay as ListRecordsResponse, az as NetworkPermissionData, aA as ReadFileRequest, aB as RepositoryInfo, aC as RevokeGitTokenRequest, aD as Signature, aE as TagObject, aF as TagTarget, aG as TreeEntry, aI as TreeObject, aJ as UpdatePermissionRequest, aK as Visibility, aL as WriteFileRequest, aq as action, av as action2, au as event, Z as kind, a0 as kind2, ac as kind3, W as type, aH as type2 } from './types.gen-BbekD8Sd.js';
+import { F as FreestyleExecuteScriptParamsConfiguration, a as FreestyleExecuteScriptResultSuccess, D as DeploymentSource, b as FreestyleDeployWebConfiguration, c as FreestyleDeployWebSuccessResponseV2, d as FreestyleCloudstateDeployRequest, e as FreestyleCloudstateDeploySuccessResponse, H as HandleBackupCloudstateResponse, f as HandleGetLogsResponse, g as HandleCreateDomainVerificationResponse, h as HandleVerifyDomainResponse, i as HandleVerifyDomainError, j as HandleListDomainsResponse, k as HandleListDomainVerificationRequestsResponse, l as HandleDeleteDomainVerificationResponse, m as HandleListWebDeploysResponse, n as HandleListExecuteRunsResponse, o as HandleGetExecuteRunResponse, p as HandleVerifyWildcardResponse, C as CreateRepositoryResponseSuccess, q as HandleListRepositoriesResponse, r as HandleDeleteRepoResponse, G as GitIdentity, s as HandleDeleteIdentityResponse, A as AccessLevel, t as HandleGrantPermissionResponse, L as ListPermissionResponseSuccess, u as DescribePermissionResponseSuccess, v as CreatedToken, w as ListGitTokensResponseSuccess, x as HandleListGitTriggersResponse, y as GitTrigger, z as GitTriggerAction, B as HandleCreateGitTriggerResponse } from './types.gen-wmZuN8DG.js';
+export { J as AccessTokenInfo, I as AccessibleRepository, K as Behavior, M as BlobEncoding, N as BlobObject, O as CommitObject, P as CommitParent, Q as CommitTree, R as CreateDomainMappingRequest, S as CreateRecordParams, T as CreateRepoRequest, V as CreateRepoSource, U as CreateRepositoryRequest, X as CustomBuildOptions, E as DeploymentBuildOptions, Y as DeploymentLogEntry, _ as DeploymentState, $ as DevServer, a1 as DevServerRequest, a2 as DevServerStatusRequest, a3 as DnsRecord, a4 as DnsRecordData, a5 as DnsRecordKind, a6 as DomainVerificationRequest, a7 as ExecRequest, a8 as ExecuteLogEntry, a9 as ExecuteRunInfo, aa as ExecuteRunState, ab as FileReadContent, ad as FreestyleCloudstateDeployConfiguration, ae as FreestyleCloudstateDeployErrorResponse, af as FreestyleDeleteDomainVerificationRequest, ag as FreestyleDeployWebErrorResponse, ah as FreestyleDeployWebPayload, ai as FreestyleDeployWebPayloadV2, aj as FreestyleDomainVerificationRequest, ak as FreestyleExecuteScriptParams, al as FreestyleFile, am as FreestyleGetLogsResponse, an as FreestyleJavaScriptLog, ao as FreestyleLogResponseObject, ap as FreestyleNetworkPermission, ar as FreestyleVerifyDomainRequest, as as GitCommitPushRequest, at as GitReference, au as GitRepositoryTrigger, ax as GrantPermissionRequest, aR as HandleBackupCloudstateData, aS as HandleBackupCloudstateError, bb as HandleCreateDomainVerificationData, bc as HandleCreateDomainVerificationError, c3 as HandleCreateGitTokenData, c5 as HandleCreateGitTokenError, c4 as HandleCreateGitTokenResponse, cx as HandleCreateGitTriggerData, cy as HandleCreateGitTriggerError, bL as HandleCreateIdentityError, bK as HandleCreateIdentityResponse, aW as HandleCreateRecordData, aY as HandleCreateRecordError, aX as HandleCreateRecordResponse, cb as HandleCreateRepoData, cd as HandleCreateRepoError, cc as HandleCreateRepoResponse, b6 as HandleDeleteDomainMappingData, b8 as HandleDeleteDomainMappingError, b7 as HandleDeleteDomainMappingResponse, bd as HandleDeleteDomainVerificationData, be as HandleDeleteDomainVerificationError, cz as HandleDeleteGitTriggerData, cB as HandleDeleteGitTriggerError, cA as HandleDeleteGitTriggerResponse, bM as HandleDeleteIdentityData, bN as HandleDeleteIdentityError, aZ as HandleDeleteRecordData, a$ as HandleDeleteRecordError, a_ as HandleDeleteRecordResponse, ce as HandleDeleteRepoData, cf as HandleDeleteRepoError, aO as HandleDeployCloudstateData, aQ as HandleDeployCloudstateError, aP as HandleDeployCloudstateResponse, cH as HandleDeployWebData, cJ as HandleDeployWebError, cI as HandleDeployWebResponse, cK as HandleDeployWebV2Data, cM as HandleDeployWebV2Error, cL as HandleDeployWebV2Response, bR as HandleDescribePermissionData, bT as HandleDescribePermissionError, bS as HandleDescribePermissionResponse, bx as HandleDevServerStatusData, bz as HandleDevServerStatusError, by as HandleDevServerStatusResponse, bf as HandleEphemeralDevServerData, bh as HandleEphemeralDevServerError, bg as HandleEphemeralDevServerResponse, bi as HandleExecOnEphemeralDevServerData, bk as HandleExecOnEphemeralDevServerError, bj as HandleExecOnEphemeralDevServerResponse, bE as HandleExecuteScriptData, bG as HandleExecuteScriptError, bF as HandleExecuteScriptResponse, cg as HandleGetBlobData, ci as HandleGetBlobError, ch as HandleGetBlobResponse, cj as HandleGetCommitData, cl as HandleGetCommitError, ck as HandleGetCommitResponse, bC as HandleGetExecuteRunData, bD as HandleGetExecuteRunError, cC as HandleGetLogsData, cD as HandleGetLogsError, cm as HandleGetRefBranchData, co as HandleGetRefBranchError, cn as HandleGetRefBranchResponse, cE as HandleGetRefTagData, cG as HandleGetRefTagError, cF as HandleGetRefTagResponse, cp as HandleGetTagData, cr as HandleGetTagError, cq as HandleGetTagResponse, cs as HandleGetTreeData, cu as HandleGetTreeError, ct as HandleGetTreeResponse, cP as HandleGetWebDeployDetailsData, br as HandleGitCommitPushData, bt as HandleGitCommitPushError, bs as HandleGitCommitPushResponse, bU as HandleGrantPermissionData, bV as HandleGrantPermissionError, b3 as HandleInsertDomainMappingData, b5 as HandleInsertDomainMappingError, b4 as HandleInsertDomainMappingResponse, b9 as HandleListDomainVerificationRequestsError, b2 as HandleListDomainsError, bA as HandleListExecuteRunsData, bB as HandleListExecuteRunsError, c0 as HandleListGitTokensData, c2 as HandleListGitTokensError, c1 as HandleListGitTokensResponse, cv as HandleListGitTriggersData, cw as HandleListGitTriggersError, bH as HandleListIdentitiesData, bJ as HandleListIdentitiesError, bI as HandleListIdentitiesResponse, bO as HandleListPermissionsData, bQ as HandleListPermissionsError, bP as HandleListPermissionsResponse, aT as HandleListRecordsData, aV as HandleListRecordsError, aU as HandleListRecordsResponse, c9 as HandleListRepositoriesData, ca as HandleListRepositoriesError, cN as HandleListWebDeploysData, cO as HandleListWebDeploysError, bo as HandleReadFileFromEphemeralDevServerData, bq as HandleReadFileFromEphemeralDevServerError, bp as HandleReadFileFromEphemeralDevServerResponse, c6 as HandleRevokeGitTokenData, c8 as HandleRevokeGitTokenError, c7 as HandleRevokeGitTokenResponse, bW as HandleRevokePermissionData, bY as HandleRevokePermissionError, bX as HandleRevokePermissionResponse, bu as HandleShutdownDevServerData, bw as HandleShutdownDevServerError, bv as HandleShutdownDevServerResponse, bZ as HandleUpdatePermissionData, b$ as HandleUpdatePermissionError, b_ as HandleUpdatePermissionResponse, ba as HandleVerifyDomainData, b0 as HandleVerifyWildcardData, b1 as HandleVerifyWildcardError, bl as HandleWriteFileFromEphemeralDevServerData, bn as HandleWriteFileFromEphemeralDevServerError, bm as HandleWriteFileFromEphemeralDevServerResponse, ay as InternalServerError, az as ListRecordsResponse, aA as NetworkPermissionData, aB as ReadFileRequest, aC as RepositoryInfo, aD as RevokeGitTokenRequest, aE as ShutdownDevServerRequest, aF as Signature, aG as TagObject, aH as TagTarget, aI as TreeEntry, aK as TreeObject, aL as UpdatePermissionRequest, aM as Visibility, aN as WriteFileRequest, aq as action, aw as action2, av as event, Z as kind, a0 as kind2, ac as kind3, W as type, aJ as type2 } from './types.gen-wmZuN8DG.js';
 
+interface FreestyleDevServer {
+    /**
+     * The URL for the dev server's HTTP API.
+     */
+    ephemeralUrl: string;
+    /**
+     * The URL to the MCP endpoint for the dev server.
+     */
+    mcpEphemeralUrl: string;
+    /**
+     * The URL for the VSCode server running in the dev server.
+     */
+    codeServerUrl: string;
+    /**
+     * Whether the dev server was just created.
+     */
+    isNew: boolean;
+    fs: FreestyleDevServerFilesystem;
+    process: FreestyleDevServerProcess;
+    /**
+     * Get the status of the dev server
+     */
+    status(): Promise<{
+        installing: boolean;
+        devRunning: boolean;
+    }>;
+    /**
+     * Commit and push changes to the dev server repository
+     * @param message The commit message
+     */
+    commitAndPush(message: string): Promise<void>;
+    /**
+     * Shutdown the dev server
+     */
+    shutdown(): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+}
+interface FreestyleDevServerFilesystem {
+    /**
+     * List files in the dev server directory
+     */
+    ls(path?: string): Promise<Array<string>>;
+    /**
+     * Read a file from the dev server
+     * @param path The path to the file
+     * @param encoding The encoding to use (defaults to utf-8)
+     */
+    readFile(path: string, encoding?: string): Promise<string>;
+    /**
+     * Write a file to the dev server
+     * @param path The path to write to
+     * @param content The content to write
+     * @param encoding The encoding to use (defaults to utf-8)
+     */
+    writeFile(path: string, content: string | ArrayBufferLike, encoding?: string): Promise<void>;
+    watch(): AsyncGenerator<{
+        eventType: string;
+        filename: string;
+    }>;
+}
+interface FreestyleDevServerProcess {
+    /**
+     * Execute a command on the dev server
+     * @param cmd The command to execute
+     * @param background Whether to run the command in the background
+     */
+    exec(cmd: string, background?: boolean): Promise<{
+        id: string;
+        isNew: boolean;
+        stdout?: string[];
+        stderr?: string[];
+    }>;
+}
+
+type Options = {
+    /**
+     * The base URL for the API.
+     */
+    baseUrl?: string;
+    /**
+     * The API key to use for requests.
+     */
+    apiKey?: string;
+    /**
+     * Custom Headers to be sent with each request.
+     */
+    headers?: Record<string, string>;
+};
 declare class FreestyleSandboxes {
     private client;
-    constructor(options: {
-        /**
-         * The base URL for the API.
-         */
-        baseUrl?: string;
-        /**
-         * The API key to use for requests.
-         */
-        apiKey: string;
-        /**
-         * Custom Headers to be sent with each request.
-         */
-        headers?: Record<string, string>;
-    });
+    options: Options;
+    constructor(options?: Options);
     /**
      * Execute a script in a sandbox.
      */
@@ -186,18 +264,18 @@ declare class FreestyleSandboxes {
          */
         repoUrl?: string;
         repoId?: string;
+        /**
+         * @deprecated
+         */
         repo?: string;
         baseId?: string;
         devCommand?: string;
-    }): Promise<{
-        mcpEphemeralUrl: any;
-        ephemeralUrl: string;
-        codeServerUrl: any;
-        url: string;
-        isNew: boolean;
-        devCommandRunning: boolean;
-        installCommandRunning: boolean;
-    }>;
+        preDevCommandOnce?: string;
+        envVars?: Record<string, string>;
+        computeClass?: string;
+        timeout?: number;
+    }): Promise<FreestyleDevServer>;
+    fetch(path: string, init?: RequestInit): Promise<Response>;
 }
 
 export { AccessLevel, CreateRepositoryResponseSuccess, CreatedToken, DeploymentSource, DescribePermissionResponseSuccess, FreestyleCloudstateDeployRequest, FreestyleCloudstateDeploySuccessResponse, FreestyleDeployWebConfiguration, FreestyleDeployWebSuccessResponseV2, FreestyleExecuteScriptParamsConfiguration, FreestyleExecuteScriptResultSuccess, FreestyleSandboxes, GitIdentity, GitTrigger, GitTriggerAction, HandleBackupCloudstateResponse, HandleCreateDomainVerificationResponse, HandleCreateGitTriggerResponse, HandleDeleteDomainVerificationResponse, HandleDeleteIdentityResponse, HandleDeleteRepoResponse, HandleGetExecuteRunResponse, HandleGetLogsResponse, HandleGrantPermissionResponse, HandleListDomainVerificationRequestsResponse, HandleListDomainsResponse, HandleListExecuteRunsResponse, HandleListGitTriggersResponse, HandleListRepositoriesResponse, HandleListWebDeploysResponse, HandleVerifyDomainError, HandleVerifyDomainResponse, HandleVerifyWildcardResponse, ListGitTokensResponseSuccess, ListPermissionResponseSuccess };

package/dist/index.d.mts

@@ -1,22 +1,100 @@
-import { F as FreestyleExecuteScriptParamsConfiguration, a as FreestyleExecuteScriptResultSuccess, D as DeploymentSource, b as FreestyleDeployWebConfiguration, c as FreestyleDeployWebSuccessResponseV2, d as FreestyleCloudstateDeployRequest, e as FreestyleCloudstateDeploySuccessResponse, H as HandleBackupCloudstateResponse, f as HandleGetLogsResponse, g as HandleCreateDomainVerificationResponse, h as HandleVerifyDomainResponse, i as HandleVerifyDomainError, j as HandleListDomainsResponse, k as HandleListDomainVerificationRequestsResponse, l as HandleDeleteDomainVerificationResponse, m as HandleListWebDeploysResponse, n as HandleListExecuteRunsResponse, o as HandleGetExecuteRunResponse, p as HandleVerifyWildcardResponse, C as CreateRepositoryResponseSuccess, q as HandleListRepositoriesResponse, r as HandleDeleteRepoResponse, G as GitIdentity, s as HandleDeleteIdentityResponse, A as AccessLevel, t as HandleGrantPermissionResponse, L as ListPermissionResponseSuccess, u as DescribePermissionResponseSuccess, v as CreatedToken, w as ListGitTokensResponseSuccess, x as HandleListGitTriggersResponse, y as GitTrigger, z as GitTriggerAction, B as HandleCreateGitTriggerResponse } from './types.gen-BbekD8Sd.js';
-export { J as AccessTokenInfo, I as AccessibleRepository, K as Behavior, M as BlobEncoding, N as BlobObject, O as CommitObject, P as CommitParent, Q as CommitTree, R as CreateDomainMappingRequest, S as CreateRecordParams, T as CreateRepoRequest, V as CreateRepoSource, U as CreateRepositoryRequest, X as CustomBuildOptions, E as DeploymentBuildOptions, Y as DeploymentLogEntry, _ as DeploymentState, $ as DevServer, a1 as DevServerRequest, a2 as DevServerStatusRequest, a3 as DnsRecord, a4 as DnsRecordData, a5 as DnsRecordKind, a6 as DomainVerificationRequest, a7 as ExecRequest, a8 as ExecuteLogEntry, a9 as ExecuteRunInfo, aa as ExecuteRunState, ab as FileReadContent, ad as FreestyleCloudstateDeployConfiguration, ae as FreestyleCloudstateDeployErrorResponse, af as FreestyleDeleteDomainVerificationRequest, ag as FreestyleDeployWebErrorResponse, ah as FreestyleDeployWebPayload, ai as FreestyleDeployWebPayloadV2, aj as FreestyleDomainVerificationRequest, ak as FreestyleExecuteScriptParams, al as FreestyleFile, am as FreestyleGetLogsResponse, an as FreestyleJavaScriptLog, ao as FreestyleLogResponseObject, ap as FreestyleNetworkPermission, ar as FreestyleVerifyDomainRequest, as as GitCommitPushRequest, at as GitRepositoryTrigger, aw as GrantPermissionRequest, aP as HandleBackupCloudstateData, aQ as HandleBackupCloudstateError, b9 as HandleCreateDomainVerificationData, ba as HandleCreateDomainVerificationError, b_ as HandleCreateGitTokenData, c0 as HandleCreateGitTokenError, b$ as HandleCreateGitTokenResponse, cp as HandleCreateGitTriggerData, cq as HandleCreateGitTriggerError, bG as HandleCreateIdentityError, bF as HandleCreateIdentityResponse, aU as HandleCreateRecordData, aW as HandleCreateRecordError, aV as HandleCreateRecordResponse, c6 as HandleCreateRepoData, c8 as HandleCreateRepoError, c7 as HandleCreateRepoResponse, b4 as HandleDeleteDomainMappingData, b6 as HandleDeleteDomainMappingError, b5 as HandleDeleteDomainMappingResponse, bb as HandleDeleteDomainVerificationData, bc as HandleDeleteDomainVerificationError, cr as HandleDeleteGitTriggerData, ct as HandleDeleteGitTriggerError, cs as HandleDeleteGitTriggerResponse, bH as HandleDeleteIdentityData, bI as HandleDeleteIdentityError, aX as HandleDeleteRecordData, aZ as HandleDeleteRecordError, aY as HandleDeleteRecordResponse, cl as HandleDeleteRepoData, cm as HandleDeleteRepoError, aM as HandleDeployCloudstateData, aO as HandleDeployCloudstateError, aN as HandleDeployCloudstateResponse, cw as HandleDeployWebData, cy as HandleDeployWebError, cx as HandleDeployWebResponse, cz as HandleDeployWebV2Data, cB as HandleDeployWebV2Error, cA as HandleDeployWebV2Response, bM as HandleDescribePermissionData, bO as HandleDescribePermissionError, bN as HandleDescribePermissionResponse, bs as HandleDevServerStatusData, bu as HandleDevServerStatusError, bt as HandleDevServerStatusResponse, bd as HandleEphemeralDevServerData, bf as HandleEphemeralDevServerError, be as HandleEphemeralDevServerResponse, bg as HandleExecOnEphemeralDevServerData, bi as HandleExecOnEphemeralDevServerError, bh as HandleExecOnEphemeralDevServerResponse, bz as HandleExecuteScriptData, bB as HandleExecuteScriptError, bA as HandleExecuteScriptResponse, c9 as HandleGetBlobData, cb as HandleGetBlobError, ca as HandleGetBlobResponse, cc as HandleGetCommitData, ce as HandleGetCommitError, cd as HandleGetCommitResponse, bx as HandleGetExecuteRunData, by as HandleGetExecuteRunError, cu as HandleGetLogsData, cv as HandleGetLogsError, cf as HandleGetTagData, ch as HandleGetTagError, cg as HandleGetTagResponse, ci as HandleGetTreeData, ck as HandleGetTreeError, cj as HandleGetTreeResponse, cE as HandleGetWebDeployDetailsData, bp as HandleGitCommitPushData, br as HandleGitCommitPushError, bq as HandleGitCommitPushResponse, bP as HandleGrantPermissionData, bQ as HandleGrantPermissionError, b1 as HandleInsertDomainMappingData, b3 as HandleInsertDomainMappingError, b2 as HandleInsertDomainMappingResponse, b7 as HandleListDomainVerificationRequestsError, b0 as HandleListDomainsError, bv as HandleListExecuteRunsData, bw as HandleListExecuteRunsError, bX as HandleListGitTokensData, bZ as HandleListGitTokensError, bY as HandleListGitTokensResponse, cn as HandleListGitTriggersData, co as HandleListGitTriggersError, bC as HandleListIdentitiesData, bE as HandleListIdentitiesError, bD as HandleListIdentitiesResponse, bJ as HandleListPermissionsData, bL as HandleListPermissionsError, bK as HandleListPermissionsResponse, aR as HandleListRecordsData, aT as HandleListRecordsError, aS as HandleListRecordsResponse, c4 as HandleListRepositoriesData, c5 as HandleListRepositoriesError, cC as HandleListWebDeploysData, cD as HandleListWebDeploysError, bm as HandleReadFileFromEphemeralDevServerData, bo as HandleReadFileFromEphemeralDevServerError, bn as HandleReadFileFromEphemeralDevServerResponse, c1 as HandleRevokeGitTokenData, c3 as HandleRevokeGitTokenError, c2 as HandleRevokeGitTokenResponse, bR as HandleRevokePermissionData, bT as HandleRevokePermissionError, bS as HandleRevokePermissionResponse, bU as HandleUpdatePermissionData, bW as HandleUpdatePermissionError, bV as HandleUpdatePermissionResponse, b8 as HandleVerifyDomainData, a_ as HandleVerifyWildcardData, a$ as HandleVerifyWildcardError, bj as HandleWriteFileFromEphemeralDevServerData, bl as HandleWriteFileFromEphemeralDevServerError, bk as HandleWriteFileFromEphemeralDevServerResponse, ax as InternalServerError, ay as ListRecordsResponse, az as NetworkPermissionData, aA as ReadFileRequest, aB as RepositoryInfo, aC as RevokeGitTokenRequest, aD as Signature, aE as TagObject, aF as TagTarget, aG as TreeEntry, aI as TreeObject, aJ as UpdatePermissionRequest, aK as Visibility, aL as WriteFileRequest, aq as action, av as action2, au as event, Z as kind, a0 as kind2, ac as kind3, W as type, aH as type2 } from './types.gen-BbekD8Sd.js';
+import { F as FreestyleExecuteScriptParamsConfiguration, a as FreestyleExecuteScriptResultSuccess, D as DeploymentSource, b as FreestyleDeployWebConfiguration, c as FreestyleDeployWebSuccessResponseV2, d as FreestyleCloudstateDeployRequest, e as FreestyleCloudstateDeploySuccessResponse, H as HandleBackupCloudstateResponse, f as HandleGetLogsResponse, g as HandleCreateDomainVerificationResponse, h as HandleVerifyDomainResponse, i as HandleVerifyDomainError, j as HandleListDomainsResponse, k as HandleListDomainVerificationRequestsResponse, l as HandleDeleteDomainVerificationResponse, m as HandleListWebDeploysResponse, n as HandleListExecuteRunsResponse, o as HandleGetExecuteRunResponse, p as HandleVerifyWildcardResponse, C as CreateRepositoryResponseSuccess, q as HandleListRepositoriesResponse, r as HandleDeleteRepoResponse, G as GitIdentity, s as HandleDeleteIdentityResponse, A as AccessLevel, t as HandleGrantPermissionResponse, L as ListPermissionResponseSuccess, u as DescribePermissionResponseSuccess, v as CreatedToken, w as ListGitTokensResponseSuccess, x as HandleListGitTriggersResponse, y as GitTrigger, z as GitTriggerAction, B as HandleCreateGitTriggerResponse } from './types.gen-wmZuN8DG.js';
+export { J as AccessTokenInfo, I as AccessibleRepository, K as Behavior, M as BlobEncoding, N as BlobObject, O as CommitObject, P as CommitParent, Q as CommitTree, R as CreateDomainMappingRequest, S as CreateRecordParams, T as CreateRepoRequest, V as CreateRepoSource, U as CreateRepositoryRequest, X as CustomBuildOptions, E as DeploymentBuildOptions, Y as DeploymentLogEntry, _ as DeploymentState, $ as DevServer, a1 as DevServerRequest, a2 as DevServerStatusRequest, a3 as DnsRecord, a4 as DnsRecordData, a5 as DnsRecordKind, a6 as DomainVerificationRequest, a7 as ExecRequest, a8 as ExecuteLogEntry, a9 as ExecuteRunInfo, aa as ExecuteRunState, ab as FileReadContent, ad as FreestyleCloudstateDeployConfiguration, ae as FreestyleCloudstateDeployErrorResponse, af as FreestyleDeleteDomainVerificationRequest, ag as FreestyleDeployWebErrorResponse, ah as FreestyleDeployWebPayload, ai as FreestyleDeployWebPayloadV2, aj as FreestyleDomainVerificationRequest, ak as FreestyleExecuteScriptParams, al as FreestyleFile, am as FreestyleGetLogsResponse, an as FreestyleJavaScriptLog, ao as FreestyleLogResponseObject, ap as FreestyleNetworkPermission, ar as FreestyleVerifyDomainRequest, as as GitCommitPushRequest, at as GitReference, au as GitRepositoryTrigger, ax as GrantPermissionRequest, aR as HandleBackupCloudstateData, aS as HandleBackupCloudstateError, bb as HandleCreateDomainVerificationData, bc as HandleCreateDomainVerificationError, c3 as HandleCreateGitTokenData, c5 as HandleCreateGitTokenError, c4 as HandleCreateGitTokenResponse, cx as HandleCreateGitTriggerData, cy as HandleCreateGitTriggerError, bL as HandleCreateIdentityError, bK as HandleCreateIdentityResponse, aW as HandleCreateRecordData, aY as HandleCreateRecordError, aX as HandleCreateRecordResponse, cb as HandleCreateRepoData, cd as HandleCreateRepoError, cc as HandleCreateRepoResponse, b6 as HandleDeleteDomainMappingData, b8 as HandleDeleteDomainMappingError, b7 as HandleDeleteDomainMappingResponse, bd as HandleDeleteDomainVerificationData, be as HandleDeleteDomainVerificationError, cz as HandleDeleteGitTriggerData, cB as HandleDeleteGitTriggerError, cA as HandleDeleteGitTriggerResponse, bM as HandleDeleteIdentityData, bN as HandleDeleteIdentityError, aZ as HandleDeleteRecordData, a$ as HandleDeleteRecordError, a_ as HandleDeleteRecordResponse, ce as HandleDeleteRepoData, cf as HandleDeleteRepoError, aO as HandleDeployCloudstateData, aQ as HandleDeployCloudstateError, aP as HandleDeployCloudstateResponse, cH as HandleDeployWebData, cJ as HandleDeployWebError, cI as HandleDeployWebResponse, cK as HandleDeployWebV2Data, cM as HandleDeployWebV2Error, cL as HandleDeployWebV2Response, bR as HandleDescribePermissionData, bT as HandleDescribePermissionError, bS as HandleDescribePermissionResponse, bx as HandleDevServerStatusData, bz as HandleDevServerStatusError, by as HandleDevServerStatusResponse, bf as HandleEphemeralDevServerData, bh as HandleEphemeralDevServerError, bg as HandleEphemeralDevServerResponse, bi as HandleExecOnEphemeralDevServerData, bk as HandleExecOnEphemeralDevServerError, bj as HandleExecOnEphemeralDevServerResponse, bE as HandleExecuteScriptData, bG as HandleExecuteScriptError, bF as HandleExecuteScriptResponse, cg as HandleGetBlobData, ci as HandleGetBlobError, ch as HandleGetBlobResponse, cj as HandleGetCommitData, cl as HandleGetCommitError, ck as HandleGetCommitResponse, bC as HandleGetExecuteRunData, bD as HandleGetExecuteRunError, cC as HandleGetLogsData, cD as HandleGetLogsError, cm as HandleGetRefBranchData, co as HandleGetRefBranchError, cn as HandleGetRefBranchResponse, cE as HandleGetRefTagData, cG as HandleGetRefTagError, cF as HandleGetRefTagResponse, cp as HandleGetTagData, cr as HandleGetTagError, cq as HandleGetTagResponse, cs as HandleGetTreeData, cu as HandleGetTreeError, ct as HandleGetTreeResponse, cP as HandleGetWebDeployDetailsData, br as HandleGitCommitPushData, bt as HandleGitCommitPushError, bs as HandleGitCommitPushResponse, bU as HandleGrantPermissionData, bV as HandleGrantPermissionError, b3 as HandleInsertDomainMappingData, b5 as HandleInsertDomainMappingError, b4 as HandleInsertDomainMappingResponse, b9 as HandleListDomainVerificationRequestsError, b2 as HandleListDomainsError, bA as HandleListExecuteRunsData, bB as HandleListExecuteRunsError, c0 as HandleListGitTokensData, c2 as HandleListGitTokensError, c1 as HandleListGitTokensResponse, cv as HandleListGitTriggersData, cw as HandleListGitTriggersError, bH as HandleListIdentitiesData, bJ as HandleListIdentitiesError, bI as HandleListIdentitiesResponse, bO as HandleListPermissionsData, bQ as HandleListPermissionsError, bP as HandleListPermissionsResponse, aT as HandleListRecordsData, aV as HandleListRecordsError, aU as HandleListRecordsResponse, c9 as HandleListRepositoriesData, ca as HandleListRepositoriesError, cN as HandleListWebDeploysData, cO as HandleListWebDeploysError, bo as HandleReadFileFromEphemeralDevServerData, bq as HandleReadFileFromEphemeralDevServerError, bp as HandleReadFileFromEphemeralDevServerResponse, c6 as HandleRevokeGitTokenData, c8 as HandleRevokeGitTokenError, c7 as HandleRevokeGitTokenResponse, bW as HandleRevokePermissionData, bY as HandleRevokePermissionError, bX as HandleRevokePermissionResponse, bu as HandleShutdownDevServerData, bw as HandleShutdownDevServerError, bv as HandleShutdownDevServerResponse, bZ as HandleUpdatePermissionData, b$ as HandleUpdatePermissionError, b_ as HandleUpdatePermissionResponse, ba as HandleVerifyDomainData, b0 as HandleVerifyWildcardData, b1 as HandleVerifyWildcardError, bl as HandleWriteFileFromEphemeralDevServerData, bn as HandleWriteFileFromEphemeralDevServerError, bm as HandleWriteFileFromEphemeralDevServerResponse, ay as InternalServerError, az as ListRecordsResponse, aA as NetworkPermissionData, aB as ReadFileRequest, aC as RepositoryInfo, aD as RevokeGitTokenRequest, aE as ShutdownDevServerRequest, aF as Signature, aG as TagObject, aH as TagTarget, aI as TreeEntry, aK as TreeObject, aL as UpdatePermissionRequest, aM as Visibility, aN as WriteFileRequest, aq as action, aw as action2, av as event, Z as kind, a0 as kind2, ac as kind3, W as type, aJ as type2 } from './types.gen-wmZuN8DG.js';
 
+interface FreestyleDevServer {
+    /**
+     * The URL for the dev server's HTTP API.
+     */
+    ephemeralUrl: string;
+    /**
+     * The URL to the MCP endpoint for the dev server.
+     */
+    mcpEphemeralUrl: string;
+    /**
+     * The URL for the VSCode server running in the dev server.
+     */
+    codeServerUrl: string;
+    /**
+     * Whether the dev server was just created.
+     */
+    isNew: boolean;
+    fs: FreestyleDevServerFilesystem;
+    process: FreestyleDevServerProcess;
+    /**
+     * Get the status of the dev server
+     */
+    status(): Promise<{
+        installing: boolean;
+        devRunning: boolean;
+    }>;
+    /**
+     * Commit and push changes to the dev server repository
+     * @param message The commit message
+     */
+    commitAndPush(message: string): Promise<void>;
+    /**
+     * Shutdown the dev server
+     */
+    shutdown(): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+}
+interface FreestyleDevServerFilesystem {
+    /**
+     * List files in the dev server directory
+     */
+    ls(path?: string): Promise<Array<string>>;
+    /**
+     * Read a file from the dev server
+     * @param path The path to the file
+     * @param encoding The encoding to use (defaults to utf-8)
+     */
+    readFile(path: string, encoding?: string): Promise<string>;
+    /**
+     * Write a file to the dev server
+     * @param path The path to write to
+     * @param content The content to write
+     * @param encoding The encoding to use (defaults to utf-8)
+     */
+    writeFile(path: string, content: string | ArrayBufferLike, encoding?: string): Promise<void>;
+    watch(): AsyncGenerator<{
+        eventType: string;
+        filename: string;
+    }>;
+}
+interface FreestyleDevServerProcess {
+    /**
+     * Execute a command on the dev server
+     * @param cmd The command to execute
+     * @param background Whether to run the command in the background
+     */
+    exec(cmd: string, background?: boolean): Promise<{
+        id: string;
+        isNew: boolean;
+        stdout?: string[];
+        stderr?: string[];
+    }>;
+}
+
+type Options = {
+    /**
+     * The base URL for the API.
+     */
+    baseUrl?: string;
+    /**
+     * The API key to use for requests.
+     */
+    apiKey?: string;
+    /**
+     * Custom Headers to be sent with each request.
+     */
+    headers?: Record<string, string>;
+};
 declare class FreestyleSandboxes {
     private client;
-    constructor(options: {
-        /**
-         * The base URL for the API.
-         */
-        baseUrl?: string;
-        /**
-         * The API key to use for requests.
-         */
-        apiKey: string;
-        /**
-         * Custom Headers to be sent with each request.
-         */
-        headers?: Record<string, string>;
-    });
+    options: Options;
+    constructor(options?: Options);
     /**
      * Execute a script in a sandbox.
      */
@@ -186,18 +264,18 @@ declare class FreestyleSandboxes {
          */
         repoUrl?: string;
         repoId?: string;
+        /**
+         * @deprecated
+         */
         repo?: string;
         baseId?: string;
         devCommand?: string;
-    }): Promise<{
-        mcpEphemeralUrl: any;
-        ephemeralUrl: string;
-        codeServerUrl: any;
-        url: string;
-        isNew: boolean;
-        devCommandRunning: boolean;
-        installCommandRunning: boolean;
-    }>;
+        preDevCommandOnce?: string;
+        envVars?: Record<string, string>;
+        computeClass?: string;
+        timeout?: number;
+    }): Promise<FreestyleDevServer>;
+    fetch(path: string, init?: RequestInit): Promise<Response>;
 }
 
 export { AccessLevel, CreateRepositoryResponseSuccess, CreatedToken, DeploymentSource, DescribePermissionResponseSuccess, FreestyleCloudstateDeployRequest, FreestyleCloudstateDeploySuccessResponse, FreestyleDeployWebConfiguration, FreestyleDeployWebSuccessResponseV2, FreestyleExecuteScriptParamsConfiguration, FreestyleExecuteScriptResultSuccess, FreestyleSandboxes, GitIdentity, GitTrigger, GitTriggerAction, HandleBackupCloudstateResponse, HandleCreateDomainVerificationResponse, HandleCreateGitTriggerResponse, HandleDeleteDomainVerificationResponse, HandleDeleteIdentityResponse, HandleDeleteRepoResponse, HandleGetExecuteRunResponse, HandleGetLogsResponse, HandleGrantPermissionResponse, HandleListDomainVerificationRequestsResponse, HandleListDomainsResponse, HandleListExecuteRunsResponse, HandleListGitTriggersResponse, HandleListRepositoriesResponse, HandleListWebDeploysResponse, HandleVerifyDomainError, HandleVerifyDomainResponse, HandleVerifyWildcardResponse, ListGitTokensResponseSuccess, ListPermissionResponseSuccess };