@buddy-works/sandbox-sdk 0.1.4-rc.0 → 0.1.5

package/README.md

@@ -45,6 +45,34 @@ export BUDDY_PROJECT="your-project"
 export BUDDY_REGION="US"  # Optional: US (default), EU, or AP
 ```
 
+## Apps
+
+Sandboxes can run multiple apps simultaneously. Each app is a long-running process defined by a command string.
+
+```typescript
+const sandbox = await Sandbox.create({
+    identifier: "my-sandbox",
+    name: "My Sandbox",
+    os: "ubuntu:24.04",
+    first_boot_commands: "apt-get update && apt-get install -y curl",
+    apps: ["node server.js", "python worker.py"],
+});
+
+// List apps
+for (const app of sandbox.data.apps ?? []) {
+    console.log(`${app.id}: "${app.command}" -> ${app.app_status}`);
+}
+
+// Control individual apps
+const appId = sandbox.data.apps![0].id!;
+
+await sandbox.stopApp(appId);
+await sandbox.startApp(appId);
+
+const { logs } = await sandbox.getAppLogs(appId);
+console.log(logs);
+```
+
 ## Regions
 
 Configure the API region:

package/dist/index.d.mts

@@ -88,6 +88,10 @@ type SandboxIdView = {
        * The current status of the sandbox
        */
   status?: "STARTING" | "STOPPING" | "FAILED" | "RUNNING" | "STOPPED" | "RESTORING";
+  /**
+       * The current setup status of the sandbox
+       */
+  setup_status?: "INPROGRESS" | "SUCCESS" | "FAILED";
 };
 /**
  * Integration reference
@@ -116,7 +120,7 @@ type IntegrationIdView = {
   /**
        * The type of integration
        */
-  type?: "GIT_HUB" | "BITBUCKET" | "GOOGLE" | "DIGITAL_OCEAN" | "SLACK" | "MODULUS" | "HEROKU" | "AMAZON" | "GIT_LAB" | "SHOPIFY" | "GIT_HUB_ENTERPRISE" | "GIT_LAB_ENTERPRISE" | "PUSHOVER" | "PUSHBULLET" | "RACKSPACE" | "CUSTOM" | "CLOUDFLARE" | "NEW_RELIC" | "SENTRY" | "ROLLBAR" | "DATADOG" | "DO_SPACES" | "HONEYBADGER" | "VULTR" | "SENTRY_ENTERPRISE" | "LOGGLY" | "HIP_CHAT" | "FIREBASE" | "TELEGRAM" | "AZURE" | "UPCLOUD" | "GHOST_INSPECTOR" | "NETLIFY" | "AZURE_CLOUD" | "MICROSOFT_TEAMS" | "GOOGLE_SERVICE_ACCOUNT" | "GOOGLE_PLAY_STORE" | "DOCKER_HUB" | "APP_STORE" | "GIT_HUB_APP" | "GIT_HUB_APP_ENTERPRISE" | "GIT_HUB_API" | "ATOP" | "SNYK" | "STACK_HAWK" | "BLACKFIRE" | "BACKBLAZE" | "ONE_LOGIN" | "OKTA" | "CONTENTFUL";
+  type?: "GIT_HUB" | "BITBUCKET" | "GOOGLE" | "DIGITAL_OCEAN" | "SLACK" | "MODULUS" | "HEROKU" | "AMAZON" | "GIT_LAB" | "SHOPIFY" | "GIT_HUB_ENTERPRISE" | "GIT_LAB_ENTERPRISE" | "PUSHOVER" | "PUSHBULLET" | "RACKSPACE" | "CUSTOM" | "CLOUDFLARE" | "NEW_RELIC" | "SENTRY" | "ROLLBAR" | "DATADOG" | "DO_SPACES" | "HONEYBADGER" | "VULTR" | "SENTRY_ENTERPRISE" | "LOGGLY" | "HIP_CHAT" | "FIREBASE" | "TELEGRAM" | "AZURE" | "UPCLOUD" | "GHOST_INSPECTOR" | "NETLIFY" | "AZURE_CLOUD" | "MICROSOFT_TEAMS" | "GOOGLE_SERVICE_ACCOUNT" | "GOOGLE_PLAY_STORE" | "DOCKER_HUB" | "APP_STORE" | "GIT_HUB_APP" | "GIT_HUB_APP_ENTERPRISE" | "GIT_HUB_API" | "ATOP" | "SNYK" | "STACK_HAWK" | "BLACKFIRE" | "BACKBLAZE" | "ONE_LOGIN" | "OKTA" | "CONTENTFUL" | "JIRA";
   /**
        * The authentication method used by the integration
        */
@@ -336,9 +340,9 @@ type HttpSettingsView = {
   /**
        * Custom HTTP headers to add to requests
        */
-  request_headers?: Array<{
+  request_headers?: {
     [key: string]: string;
-  }>;
+  };
   /**
        * List of allowed User-Agent strings
        */
@@ -350,9 +354,9 @@ type HttpSettingsView = {
   /**
        * Custom HTTP headers to add to responses
        */
-  response_headers?: Array<{
+  response_headers?: {
     [key: string]: string;
-  }>;
+  };
   /**
        * Basic authentication username
        */
@@ -410,6 +414,20 @@ type TunnelView = {
        */
   endpoint_url?: string;
 };
+type SandboxAppView = {
+  /**
+       * The auto-generated ID of the app
+       */
+  id?: string;
+  /**
+       * The run command of the app
+       */
+  command?: string;
+  /**
+       * The current status of the app
+       */
+  app_status?: "NONE" | "RUNNING" | "ENDED" | "FAILED";
+};
 type SandboxesView = {
   /**
        * API endpoint to GET this object
@@ -496,6 +514,14 @@ type SandboxCommandView = {
        * Command exit code
        */
   exit_code?: number;
+  /**
+       * Command execution start date
+       */
+  start_date?: Date;
+  /**
+       * Command execution finish date
+       */
+  finish_date?: Date;
   /**
        * API endpoint URL to retrieve logs for this command
        */
@@ -511,6 +537,24 @@ type SandboxCommandLog = {
        */
   data?: string;
 };
+type SandboxAppLogsView = {
+  /**
+       * API endpoint to GET this object
+       */
+  readonly url?: string;
+  /**
+       * Web URL to view this object in Buddy.works
+       */
+  readonly html_url?: string;
+  /**
+       * Cursor for pagination
+       */
+  cursor?: string;
+  /**
+       * Application log entries
+       */
+  logs?: Array<string>;
+};
 type ExecuteSandboxCommandRequest = {
   /**
        * Command to execute in the sandbox
@@ -521,9 +565,6 @@ type ExecuteSandboxCommandRequest = {
        */
   runtime?: "BASH" | "JAVASCRIPT" | "TYPESCRIPT" | "PYTHON";
 };
-/**
- * The list of variables you can use the action
- */
 type EnvironmentVariableView = {
   /**
        * The ID of the variable
@@ -645,6 +686,10 @@ type SandboxResponse = {
        * The current status of the sandbox
        */
   status?: "STARTING" | "STOPPING" | "FAILED" | "RUNNING" | "STOPPED" | "RESTORING";
+  /**
+       * The current setup status of the sandbox
+       */
+  setup_status?: "INPROGRESS" | "SUCCESS" | "FAILED" | "STALE";
   /**
        * The operating system of the sandbox ["ubuntu:22.04", "ubuntu:24.04"]
        */
@@ -654,37 +699,29 @@ type SandboxResponse = {
        */
   resources?: "1x2" | "2x4" | "3x6" | "4x8" | "5x10" | "6x12" | "7x14" | "8x16" | "9x18" | "10x20" | "11x22" | "12x24" | "CUSTOM";
   /**
-       * The commands to run during setup of the sandbox
-       */
-  install_commands?: string;
-  /**
-       * The run command of the sandbox
+       * The commands to run during first boot of the sandbox
        */
-  run_command?: string;
+  first_boot_commands?: string;
   /**
        * The application directory of the sandbox
        */
   app_dir?: string;
   /**
-       * The application type of the sandbox (passed command or existent service eg. apache2)
+       * The list of apps (run commands) for the sandbox
        */
-  app_type?: "CMD" | "SERVICE";
+  apps?: Array<SandboxAppView>;
   /**
-       * The list of tags associated with the sandbox
+       * The timeout in seconds after which the sandbox will be automatically stopped
        */
-  tags?: Array<string>;
+  timeout?: number;
   /**
-       * The current application status of the sandbox
+       * The list of tags associated with the sandbox
        */
-  app_status?: "NONE" | "RUNNING" | "ENDED" | "FAILED";
+  tags?: Array<string>;
   /**
        * The boot logs of the sandbox
        */
   boot_logs?: Array<string>;
-  /**
-       * The current setup status of the sandbox
-       */
-  setup_status?: "INPROGRESS" | "SUCCESS" | "FAILED";
   /**
        * The tunnel endpoints of the sandbox
        */
@@ -805,9 +842,9 @@ type HttpSettingsViewWritable = {
   /**
        * Custom HTTP headers to add to requests
        */
-  request_headers?: Array<{
+  request_headers?: {
     [key: string]: string;
-  }>;
+  };
   /**
        * List of allowed User-Agent strings
        */
@@ -819,9 +856,9 @@ type HttpSettingsViewWritable = {
   /**
        * Custom HTTP headers to add to responses
        */
-  response_headers?: Array<{
+  response_headers?: {
     [key: string]: string;
-  }>;
+  };
   /**
        * Basic authentication username
        */
@@ -897,21 +934,17 @@ type CreateNewSandboxRequestWritable = {
        */
   resources?: "1x2" | "2x4" | "3x6" | "4x8" | "5x10" | "6x12" | "7x14" | "8x16" | "9x18" | "10x20" | "11x22" | "12x24" | "CUSTOM";
   /**
-       * The commands to run during setup of the sandbox
-       */
-  install_commands?: string;
-  /**
-       * The run command of the sandbox
+       * The commands to run during first boot of the sandbox
        */
-  run_command?: string;
+  first_boot_commands?: string;
   /**
        * The application directory of the sandbox
        */
   app_dir?: string;
   /**
-       * The application type of the sandbox (passed command or existent service eg. apache2)
+       * The list of apps (run commands) for the sandbox
        */
-  app_type?: "CMD" | "SERVICE";
+  apps?: Array<string>;
   /**
        * The list of tags associated with the sandbox
        */
@@ -924,6 +957,11 @@ type CreateNewSandboxRequestWritable = {
        * The environment variables of the sandbox
        */
   variables?: Array<AddVariableInObjectRequestWritable>;
+  /**
+       * The timeout in seconds after which the sandbox will be automatically stopped
+       */
+  timeout?: number;
+  permissions?: PermissionsView;
 };
 type CreateFromSnapshotRequestWritable = {
   /**
@@ -947,21 +985,17 @@ type CreateFromSnapshotRequestWritable = {
        */
   resources?: "1x2" | "2x4" | "3x6" | "4x8" | "5x10" | "6x12" | "7x14" | "8x16" | "9x18" | "10x20" | "11x22" | "12x24" | "CUSTOM";
   /**
-       * The commands to run during setup of the sandbox
-       */
-  install_commands?: string;
-  /**
-       * The run command of the sandbox
+       * The commands to run during first boot of the sandbox
        */
-  run_command?: string;
+  first_boot_commands?: string;
   /**
        * The application directory of the sandbox
        */
   app_dir?: string;
   /**
-       * The application type of the sandbox (passed command or existent service eg. apache2)
+       * The list of apps (run commands) for the sandbox
        */
-  app_type?: "CMD" | "SERVICE";
+  apps?: Array<string>;
   /**
        * The list of tags associated with the sandbox
        */
@@ -1077,6 +1111,72 @@ type GetSandboxResponses = {
   200: SandboxResponse;
 };
 type GetSandboxResponse = GetSandboxResponses[keyof GetSandboxResponses];
+type GetSandboxAppLogsByIdData = {
+  body?: never;
+  path: {
+    /**
+             * The human-readable ID of the workspace
+             */
+    workspace_domain: string;
+    /**
+             * The ID of the sandbox
+             */
+    sandbox_id: string;
+    /**
+             * The ID of the app
+             */
+    app_id: string;
+  };
+  query?: {
+    /**
+             * Cursor for pagination
+             */
+    cursor?: string;
+  };
+  url: "/workspaces/{workspace_domain}/sandboxes/{sandbox_id}/apps/{app_id}/logs";
+};
+type GetSandboxAppLogsByIdResponses = {
+  200: SandboxAppLogsView;
+};
+type GetSandboxAppLogsByIdResponse = GetSandboxAppLogsByIdResponses[keyof GetSandboxAppLogsByIdResponses];
+type StartSandboxAppData = {
+  body?: never;
+  path: {
+    /**
+             * The human-readable ID of the workspace
+             */
+    workspace_domain: string;
+    /**
+             * The ID of the sandbox
+             */
+    sandbox_id: string;
+    /**
+             * The ID of the app
+             */
+    app_id: string;
+  };
+  query?: never;
+  url: "/workspaces/{workspace_domain}/sandboxes/{sandbox_id}/apps/{app_id}/start";
+};
+type StopSandboxAppData = {
+  body?: never;
+  path: {
+    /**
+             * The human-readable ID of the workspace
+             */
+    workspace_domain: string;
+    /**
+             * The ID of the sandbox
+             */
+    sandbox_id: string;
+    /**
+             * The ID of the app
+             */
+    app_id: string;
+  };
+  query?: never;
+  url: "/workspaces/{workspace_domain}/sandboxes/{sandbox_id}/apps/{app_id}/stop";
+};
 type ExecuteSandboxCommandData = {
   body?: ExecuteSandboxCommandRequest;
   path: {
@@ -1406,6 +1506,12 @@ declare class BuddyApiClient extends HttpClient {
   stopSandbox<const Data$1 extends StopSandboxData>(data: ClientData<Data$1>): Promise<SandboxResponse>;
   /** Restart a sandbox */
   restartSandbox<const Data$1 extends RestartSandboxData>(data: ClientData<Data$1>): Promise<SandboxResponse>;
+  /** Start a sandbox app */
+  startSandboxApp<const Data$1 extends StartSandboxAppData>(data: ClientData<Data$1>): Promise<SandboxResponse>;
+  /** Stop a sandbox app */
+  stopSandboxApp<const Data$1 extends StopSandboxAppData>(data: ClientData<Data$1>): Promise<SandboxResponse>;
+  /** Get logs for a specific sandbox app */
+  getSandboxAppLogs<const Data$1 extends GetSandboxAppLogsByIdData>(data: ClientData<Data$1>): Promise<SandboxAppLogsView>;
   /** Get sandbox content (list files/directories at a path) */
   getSandboxContent<const Data$1 extends GetSandboxContentData>(data: ClientData<Data$1>): Promise<GetSandboxContentResponse>;
   /** Delete a file or directory from a sandbox */
@@ -1721,6 +1827,29 @@ declare class Sandbox {
        * Waits until the sandbox reaches RUNNING state and setup is complete
        */
   restart(): Promise<void>;
+  /**
+       * Start a specific app within the sandbox
+       *
+       * Updates the internal sandbox data with the latest state after starting.
+       * @param appId - The auto-generated ID of the app (from sandbox.data.apps)
+       */
+  startApp(appId: NonNullable<SandboxAppView["id"]>): Promise<void>;
+  /**
+       * Stop a specific app within the sandbox
+       *
+       * Updates the internal sandbox data with the latest state after stopping.
+       * @param appId - The auto-generated ID of the app (from sandbox.data.apps)
+       */
+  stopApp(appId: NonNullable<SandboxAppView["id"]>): Promise<void>;
+  /**
+       * Get logs for a specific app within the sandbox
+       *
+       * Returns paginated log entries. Pass the returned cursor to fetch the next page.
+       * @param appId - The auto-generated ID of the app (from sandbox.data.apps)
+       * @param cursor - Pagination cursor from a previous response
+       * @returns Log entries and a cursor for the next page
+       */
+  getAppLogs(appId: NonNullable<SandboxAppView["id"]>, cursor?: string): Promise<GetSandboxAppLogsByIdResponse>;
   private constructor();
 }
 //#endregion
@@ -1744,4 +1873,4 @@ declare class BuddySDKError extends Error {
   });
 }
 //#endregion
-export { API_URLS, BuddyApiClient, BuddySDKError, Command, type ConnectionConfig, type CreateSandboxConfig, ERROR_CODES, type ErrorCode, type FileInfo, FileSystem, type GetFileSystemConfig, type GetSandboxConfig, type ListSandboxesConfig, REGIONS, type Region, Sandbox, type SandboxIdView };
+export { API_URLS, BuddyApiClient, BuddySDKError, Command, type ConnectionConfig, type CreateSandboxConfig, ERROR_CODES, type ErrorCode, type FileInfo, FileSystem, type GetFileSystemConfig, type GetSandboxConfig, type ListSandboxesConfig, REGIONS, type Region, Sandbox, type SandboxAppView, type SandboxIdView };

package/dist/index.mjs

@@ -20,6 +20,31 @@ const getSandboxResponseTransformer = async (data) => {
 	data = sandboxResponseSchemaResponseTransformer(data);
 	return data;
 };
+const startSandboxAppResponseTransformer = async (data) => {
+	data = sandboxResponseSchemaResponseTransformer(data);
+	return data;
+};
+const stopSandboxAppResponseTransformer = async (data) => {
+	data = sandboxResponseSchemaResponseTransformer(data);
+	return data;
+};
+const sandboxCommandViewSchemaResponseTransformer = (data) => {
+	if (data.start_date) data.start_date = new Date(data.start_date);
+	if (data.finish_date) data.finish_date = new Date(data.finish_date);
+	return data;
+};
+const executeSandboxCommandResponseTransformer = async (data) => {
+	data = sandboxCommandViewSchemaResponseTransformer(data);
+	return data;
+};
+const getSandboxCommandResponseTransformer = async (data) => {
+	data = sandboxCommandViewSchemaResponseTransformer(data);
+	return data;
+};
+const terminateSandboxCommandResponseTransformer = async (data) => {
+	data = sandboxCommandViewSchemaResponseTransformer(data);
+	return data;
+};
 const sandboxContentItemSchemaResponseTransformer = (data) => {
 	if (data.size) data.size = BigInt(data.size.toString());
 	return data;
@@ -473,7 +498,8 @@ const zIntegrationView = z.object({
 		"BACKBLAZE",
 		"ONE_LOGIN",
 		"OKTA",
-		"CONTENTFUL"
+		"CONTENTFUL",
+		"JIRA"
 	])),
 	auth_type: z.optional(z.enum([
 		"OAUTH",
@@ -625,7 +651,8 @@ const zAddIntegrationRequest = z.object({
 		"BACKBLAZE",
 		"ONE_LOGIN",
 		"OKTA",
-		"CONTENTFUL"
+		"CONTENTFUL",
+		"JIRA"
 	]),
 	scope: z.enum([
 		"WORKSPACE",
@@ -650,6 +677,11 @@ const zSandboxIdView = z.object({
 		"RUNNING",
 		"STOPPED",
 		"RESTORING"
+	])),
+	setup_status: z.optional(z.enum([
+		"INPROGRESS",
+		"SUCCESS",
+		"FAILED"
 	]))
 });
 /**
@@ -711,7 +743,8 @@ const zIntegrationIdView = z.object({
 		"BACKBLAZE",
 		"ONE_LOGIN",
 		"OKTA",
-		"CONTENTFUL"
+		"CONTENTFUL",
+		"JIRA"
 	])),
 	auth_type: z.optional(z.enum([
 		"OAUTH",
@@ -854,10 +887,10 @@ const zHttpSettingsView = z.object({
 	compression: z.optional(z.boolean()),
 	http2: z.optional(z.boolean()),
 	log_requests: z.optional(z.boolean()),
-	request_headers: z.optional(z.array(z.record(z.string(), z.string()))),
+	request_headers: z.optional(z.record(z.string(), z.string())),
 	whitelist_user_agents: z.optional(z.array(z.string())),
 	rewrite_host_header: z.optional(z.string()),
-	response_headers: z.optional(z.array(z.record(z.string(), z.string()))),
+	response_headers: z.optional(z.record(z.string(), z.string())),
 	login: z.optional(z.string()),
 	circuit_breaker: z.optional(z.int().min(-2147483648, { error: "Invalid value: Expected int32 to be >= -2147483648" }).max(2147483647, { error: "Invalid value: Expected int32 to be <= 2147483647" })),
 	serve_path: z.optional(z.string()),
@@ -889,6 +922,16 @@ const zTunnelView = z.object({
 	tls: z.optional(zTlsSettingsView),
 	endpoint_url: z.optional(z.string())
 });
+const zSandboxAppView = z.object({
+	id: z.optional(z.string()),
+	command: z.optional(z.string()),
+	app_status: z.optional(z.enum([
+		"NONE",
+		"RUNNING",
+		"ENDED",
+		"FAILED"
+	]))
+});
 const zUpdateSandboxRequest = z.object({
 	name: z.optional(z.string()),
 	identifier: z.optional(z.string()),
@@ -907,10 +950,10 @@ const zUpdateSandboxRequest = z.object({
 		"12x24",
 		"CUSTOM"
 	])),
-	install_commands: z.optional(z.string()),
-	run_command: z.optional(z.string()),
+	first_boot_commands: z.optional(z.string()),
 	app_dir: z.optional(z.string()),
-	app_type: z.optional(z.enum(["CMD", "SERVICE"])),
+	apps: z.optional(z.array(zSandboxAppView)),
+	timeout: z.optional(z.int().min(-2147483648, { error: "Invalid value: Expected int32 to be >= -2147483648" }).max(2147483647, { error: "Invalid value: Expected int32 to be <= 2147483647" })),
 	tags: z.optional(z.array(z.string())),
 	endpoints: z.optional(z.array(zTunnelView)),
 	variables: z.optional(z.array(zAddVariableInObjectRequest)),
@@ -957,6 +1000,8 @@ const zSandboxCommandView = z.object({
 		"FAILED"
 	])),
 	exit_code: z.optional(z.int().min(-2147483648, { error: "Invalid value: Expected int32 to be >= -2147483648" }).max(2147483647, { error: "Invalid value: Expected int32 to be <= 2147483647" })),
+	start_date: z.optional(z.iso.datetime()),
+	finish_date: z.optional(z.iso.datetime()),
 	logs_url: z.optional(z.string())
 });
 const zSandboxCommandsView = z.object({
@@ -1042,17 +1087,15 @@ const zCreateNewSandboxRequest = z.object({
 		"12x24",
 		"CUSTOM"
 	])),
-	install_commands: z.optional(z.string()),
-	run_command: z.optional(z.string()),
+	first_boot_commands: z.optional(z.string()),
 	app_dir: z.optional(z.string()),
-	app_type: z.optional(z.enum(["CMD", "SERVICE"])),
+	apps: z.optional(z.array(z.string())),
 	tags: z.optional(z.array(z.string())),
 	endpoints: z.optional(z.array(zTunnelView)),
-	variables: z.optional(z.array(zAddVariableInObjectRequest))
+	variables: z.optional(z.array(zAddVariableInObjectRequest)),
+	timeout: z.optional(z.int().min(-2147483648, { error: "Invalid value: Expected int32 to be >= -2147483648" }).max(2147483647, { error: "Invalid value: Expected int32 to be <= 2147483647" })),
+	permissions: z.optional(zPermissionsView)
 });
-/**
-* The list of variables you can use the action
-*/
 const zEnvironmentVariableView = z.object({
 	id: z.optional(z.int().min(-2147483648, { error: "Invalid value: Expected int32 to be >= -2147483648" }).max(2147483647, { error: "Invalid value: Expected int32 to be <= 2147483647" })),
 	key: z.optional(z.string()),
@@ -1103,10 +1146,9 @@ const zCreateFromSnapshotRequest = z.object({
 		"12x24",
 		"CUSTOM"
 	])),
-	install_commands: z.optional(z.string()),
-	run_command: z.optional(z.string()),
+	first_boot_commands: z.optional(z.string()),
 	app_dir: z.optional(z.string()),
-	app_type: z.optional(z.enum(["CMD", "SERVICE"])),
+	apps: z.optional(z.array(z.string())),
 	tags: z.optional(z.array(z.string())),
 	endpoints: z.optional(z.array(zTunnelView)),
 	variables: z.optional(z.array(zEnvironmentVariableView))
@@ -1130,6 +1172,12 @@ const zSandboxResponse = z.object({
 		"STOPPED",
 		"RESTORING"
 	])),
+	setup_status: z.optional(z.enum([
+		"INPROGRESS",
+		"SUCCESS",
+		"FAILED",
+		"STALE"
+	])),
 	os: z.optional(z.string()),
 	resources: z.optional(z.enum([
 		"1x2",
@@ -1146,23 +1194,12 @@ const zSandboxResponse = z.object({
 		"12x24",
 		"CUSTOM"
 	])),
-	install_commands: z.optional(z.string()),
-	run_command: z.optional(z.string()),
+	first_boot_commands: z.optional(z.string()),
 	app_dir: z.optional(z.string()),
-	app_type: z.optional(z.enum(["CMD", "SERVICE"])),
+	apps: z.optional(z.array(zSandboxAppView)),
+	timeout: z.optional(z.int().min(-2147483648, { error: "Invalid value: Expected int32 to be >= -2147483648" }).max(2147483647, { error: "Invalid value: Expected int32 to be <= 2147483647" })),
 	tags: z.optional(z.array(z.string())),
-	app_status: z.optional(z.enum([
-		"NONE",
-		"RUNNING",
-		"ENDED",
-		"FAILED"
-	])),
 	boot_logs: z.optional(z.array(z.string())),
-	setup_status: z.optional(z.enum([
-		"INPROGRESS",
-		"SUCCESS",
-		"FAILED"
-	])),
 	endpoints: z.optional(z.array(zTunnelView)),
 	project: z.optional(zProjectView),
 	permissions: z.optional(zPermissionsView),
@@ -1370,7 +1407,8 @@ const zIntegrationViewWritable = z.object({
 		"BACKBLAZE",
 		"ONE_LOGIN",
 		"OKTA",
-		"CONTENTFUL"
+		"CONTENTFUL",
+		"JIRA"
 	])),
 	auth_type: z.optional(z.enum([
 		"OAUTH",
@@ -1424,6 +1462,11 @@ const zSandboxIdViewWritable = z.object({
 		"RUNNING",
 		"STOPPED",
 		"RESTORING"
+	])),
+	setup_status: z.optional(z.enum([
+		"INPROGRESS",
+		"SUCCESS",
+		"FAILED"
 	]))
 });
 /**
@@ -1483,7 +1526,8 @@ const zIntegrationIdViewWritable = z.object({
 		"BACKBLAZE",
 		"ONE_LOGIN",
 		"OKTA",
-		"CONTENTFUL"
+		"CONTENTFUL",
+		"JIRA"
 	])),
 	auth_type: z.optional(z.enum([
 		"OAUTH",
@@ -1597,10 +1641,10 @@ const zHttpSettingsViewWritable = z.object({
 	compression: z.optional(z.boolean()),
 	http2: z.optional(z.boolean()),
 	log_requests: z.optional(z.boolean()),
-	request_headers: z.optional(z.array(z.record(z.string(), z.string()))),
+	request_headers: z.optional(z.record(z.string(), z.string())),
 	whitelist_user_agents: z.optional(z.array(z.string())),
 	rewrite_host_header: z.optional(z.string()),
-	response_headers: z.optional(z.array(z.record(z.string(), z.string()))),
+	response_headers: z.optional(z.record(z.string(), z.string())),
 	login: z.optional(z.string()),
 	password: z.optional(z.string()),
 	tls_ca: z.optional(z.string()),
@@ -1650,10 +1694,10 @@ const zUpdateSandboxRequestWritable = z.object({
 		"12x24",
 		"CUSTOM"
 	])),
-	install_commands: z.optional(z.string()),
-	run_command: z.optional(z.string()),
+	first_boot_commands: z.optional(z.string()),
 	app_dir: z.optional(z.string()),
-	app_type: z.optional(z.enum(["CMD", "SERVICE"])),
+	apps: z.optional(z.array(zSandboxAppView)),
+	timeout: z.optional(z.int().min(-2147483648, { error: "Invalid value: Expected int32 to be >= -2147483648" }).max(2147483647, { error: "Invalid value: Expected int32 to be <= 2147483647" })),
 	tags: z.optional(z.array(z.string())),
 	endpoints: z.optional(z.array(zTunnelViewWritable)),
 	variables: z.optional(z.array(zAddVariableInObjectRequestWritable)),
@@ -1688,6 +1732,8 @@ const zSandboxCommandViewWritable = z.object({
 		"FAILED"
 	])),
 	exit_code: z.optional(z.int().min(-2147483648, { error: "Invalid value: Expected int32 to be >= -2147483648" }).max(2147483647, { error: "Invalid value: Expected int32 to be <= 2147483647" })),
+	start_date: z.optional(z.iso.datetime()),
+	finish_date: z.optional(z.iso.datetime()),
 	logs_url: z.optional(z.string())
 });
 const zSandboxCommandsViewWritable = z.object({ commands: z.optional(z.array(zSandboxCommandViewWritable)) });
@@ -1741,13 +1787,14 @@ const zCreateNewSandboxRequestWritable = z.object({
 		"12x24",
 		"CUSTOM"
 	])),
-	install_commands: z.optional(z.string()),
-	run_command: z.optional(z.string()),
+	first_boot_commands: z.optional(z.string()),
 	app_dir: z.optional(z.string()),
-	app_type: z.optional(z.enum(["CMD", "SERVICE"])),
+	apps: z.optional(z.array(z.string())),
 	tags: z.optional(z.array(z.string())),
 	endpoints: z.optional(z.array(zTunnelViewWritable)),
-	variables: z.optional(z.array(zAddVariableInObjectRequestWritable))
+	variables: z.optional(z.array(zAddVariableInObjectRequestWritable)),
+	timeout: z.optional(z.int().min(-2147483648, { error: "Invalid value: Expected int32 to be >= -2147483648" }).max(2147483647, { error: "Invalid value: Expected int32 to be <= 2147483647" })),
+	permissions: z.optional(zPermissionsView)
 });
 const zCreateFromSnapshotRequestWritable = z.object({
 	snapshot_id: z.string(),
@@ -1769,10 +1816,9 @@ const zCreateFromSnapshotRequestWritable = z.object({
 		"12x24",
 		"CUSTOM"
 	])),
-	install_commands: z.optional(z.string()),
-	run_command: z.optional(z.string()),
+	first_boot_commands: z.optional(z.string()),
 	app_dir: z.optional(z.string()),
-	app_type: z.optional(z.enum(["CMD", "SERVICE"])),
+	apps: z.optional(z.array(z.string())),
 	tags: z.optional(z.array(z.string())),
 	endpoints: z.optional(z.array(zTunnelViewWritable)),
 	variables: z.optional(z.array(zEnvironmentVariableView))
@@ -1789,6 +1835,12 @@ const zSandboxResponseWritable = z.object({
 		"STOPPED",
 		"RESTORING"
 	])),
+	setup_status: z.optional(z.enum([
+		"INPROGRESS",
+		"SUCCESS",
+		"FAILED",
+		"STALE"
+	])),
 	os: z.optional(z.string()),
 	resources: z.optional(z.enum([
 		"1x2",
@@ -1805,23 +1857,12 @@ const zSandboxResponseWritable = z.object({
 		"12x24",
 		"CUSTOM"
 	])),
-	install_commands: z.optional(z.string()),
-	run_command: z.optional(z.string()),
+	first_boot_commands: z.optional(z.string()),
 	app_dir: z.optional(z.string()),
-	app_type: z.optional(z.enum(["CMD", "SERVICE"])),
+	apps: z.optional(z.array(zSandboxAppView)),
+	timeout: z.optional(z.int().min(-2147483648, { error: "Invalid value: Expected int32 to be >= -2147483648" }).max(2147483647, { error: "Invalid value: Expected int32 to be <= 2147483647" })),
 	tags: z.optional(z.array(z.string())),
-	app_status: z.optional(z.enum([
-		"NONE",
-		"RUNNING",
-		"ENDED",
-		"FAILED"
-	])),
 	boot_logs: z.optional(z.array(z.string())),
-	setup_status: z.optional(z.enum([
-		"INPROGRESS",
-		"SUCCESS",
-		"FAILED"
-	])),
 	endpoints: z.optional(z.array(zTunnelViewWritable)),
 	project: z.optional(zProjectViewWritable),
 	permissions: z.optional(zPermissionsView),
@@ -2002,14 +2043,36 @@ const zUpdateSandboxData = z.object({
 	}),
 	query: z.optional(z.never())
 });
-const zGetSandboxAppLogsData = z.object({
+const zGetSandboxAppLogsByIdData = z.object({
 	body: z.optional(z.never()),
 	path: z.object({
 		workspace_domain: z.string(),
-		sandbox_id: z.string()
+		sandbox_id: z.string(),
+		app_id: z.string()
 	}),
 	query: z.optional(z.object({ cursor: z.optional(z.string()) }))
 });
+const zGetSandboxAppLogsByIdResponse = zSandboxAppLogsView;
+const zStartSandboxAppData = z.object({
+	body: z.optional(z.never()),
+	path: z.object({
+		workspace_domain: z.string(),
+		sandbox_id: z.string(),
+		app_id: z.string()
+	}),
+	query: z.optional(z.never())
+});
+const zStartSandboxAppResponse = zSandboxResponse;
+const zStopSandboxAppData = z.object({
+	body: z.optional(z.never()),
+	path: z.object({
+		workspace_domain: z.string(),
+		sandbox_id: z.string(),
+		app_id: z.string()
+	}),
+	query: z.optional(z.never())
+});
+const zStopSandboxAppResponse = zSandboxResponse;
 const zGetSandboxCommandsData = z.object({
 	body: z.optional(z.never()),
 	path: z.object({
@@ -2238,7 +2301,7 @@ const zUpdateSsoData = z.object({
 //#endregion
 //#region package.json
 var name = "@buddy-works/sandbox-sdk";
-var version = "0.1.4-rc.0";
+var version = "0.1.5";
 
 //#endregion
 //#region src/utils/environment.ts
@@ -2662,7 +2725,7 @@ var BuddyApiClient = class extends HttpClient {
 			data,
 			url: "/workspaces/{workspace_domain}/sandboxes/{sandbox_id}/commands",
 			dataSchema: zExecuteSandboxCommandData,
-			responseSchema: zExecuteSandboxCommandResponse
+			responseSchema: zExecuteSandboxCommandResponse.transform(executeSandboxCommandResponseTransformer)
 		});
 	}
 	/** Get a specific command execution details */
@@ -2672,7 +2735,7 @@ var BuddyApiClient = class extends HttpClient {
 			data,
 			url: "/workspaces/{workspace_domain}/sandboxes/{sandbox_id}/commands/{id}",
 			dataSchema: zGetSandboxCommandData,
-			responseSchema: zGetSandboxCommandResponse
+			responseSchema: zGetSandboxCommandResponse.transform(getSandboxCommandResponseTransformer)
 		});
 	}
 	/** Terminate a running command in a sandbox */
@@ -2682,7 +2745,7 @@ var BuddyApiClient = class extends HttpClient {
 			data,
 			url: "/workspaces/{workspace_domain}/sandboxes/{sandbox_id}/commands/{command_id}/terminate",
 			dataSchema: zTerminateSandboxCommandData,
-			responseSchema: zTerminateSandboxCommandResponse
+			responseSchema: zTerminateSandboxCommandResponse.transform(terminateSandboxCommandResponseTransformer)
 		});
 	}
 	/** Delete a sandbox by its ID */
@@ -2741,6 +2804,36 @@ var BuddyApiClient = class extends HttpClient {
 			responseSchema: zRestartSandboxResponse.transform(restartSandboxResponseTransformer)
 		});
 	}
+	/** Start a sandbox app */
+	async startSandboxApp(data) {
+		return this.#requestWithValidation({
+			method: "POST",
+			data,
+			url: "/workspaces/{workspace_domain}/sandboxes/{sandbox_id}/apps/{app_id}/start",
+			dataSchema: zStartSandboxAppData,
+			responseSchema: zStartSandboxAppResponse.transform(startSandboxAppResponseTransformer)
+		});
+	}
+	/** Stop a sandbox app */
+	async stopSandboxApp(data) {
+		return this.#requestWithValidation({
+			method: "POST",
+			data,
+			url: "/workspaces/{workspace_domain}/sandboxes/{sandbox_id}/apps/{app_id}/stop",
+			dataSchema: zStopSandboxAppData,
+			responseSchema: zStopSandboxAppResponse.transform(stopSandboxAppResponseTransformer)
+		});
+	}
+	/** Get logs for a specific sandbox app */
+	async getSandboxAppLogs(data) {
+		return this.#requestWithValidation({
+			method: "GET",
+			data,
+			url: "/workspaces/{workspace_domain}/sandboxes/{sandbox_id}/apps/{app_id}/logs",
+			dataSchema: zGetSandboxAppLogsByIdData,
+			responseSchema: zGetSandboxAppLogsByIdResponse
+		});
+	}
 	/** Get sandbox content (list files/directories at a path) */
 	async getSandboxContent(data) {
 		return this.#requestWithValidation({
@@ -3457,6 +3550,7 @@ var Sandbox = class Sandbox {
 				await this.refresh();
 				if (this.data.setup_status === "SUCCESS") return;
 				if (this.data.setup_status === "FAILED") throw new Error(`Sandbox ${sandboxId} setup failed. Status: ${this.data.setup_status}`);
+				if (this.data.setup_status === "STALE") throw new Error(`Sandbox ${sandboxId} setup is stale. The first_boot_commands were changed but not applied. Recreate the sandbox to apply them.`);
 				await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
 			}
 		});
@@ -3554,6 +3648,56 @@ var Sandbox = class Sandbox {
 			logger_default.debug(`Sandbox ${sandboxId} has been restarted and is ready. Status: ${this.data.status}, Setup status: ${this.data.setup_status}`);
 		});
 	}
+	/**
+	* Start a specific app within the sandbox
+	*
+	* Updates the internal sandbox data with the latest state after starting.
+	* @param appId - The auto-generated ID of the app (from sandbox.data.apps)
+	*/
+	async startApp(appId) {
+		const sandboxId = this.initializedId;
+		return withErrorHandler("Failed to start app", async () => {
+			this.#sandboxData = await this.#client.startSandboxApp({ path: {
+				sandbox_id: sandboxId,
+				app_id: appId
+			} });
+		});
+	}
+	/**
+	* Stop a specific app within the sandbox
+	*
+	* Updates the internal sandbox data with the latest state after stopping.
+	* @param appId - The auto-generated ID of the app (from sandbox.data.apps)
+	*/
+	async stopApp(appId) {
+		const sandboxId = this.initializedId;
+		return withErrorHandler("Failed to stop app", async () => {
+			this.#sandboxData = await this.#client.stopSandboxApp({ path: {
+				sandbox_id: sandboxId,
+				app_id: appId
+			} });
+		});
+	}
+	/**
+	* Get logs for a specific app within the sandbox
+	*
+	* Returns paginated log entries. Pass the returned cursor to fetch the next page.
+	* @param appId - The auto-generated ID of the app (from sandbox.data.apps)
+	* @param cursor - Pagination cursor from a previous response
+	* @returns Log entries and a cursor for the next page
+	*/
+	async getAppLogs(appId, cursor) {
+		const sandboxId = this.initializedId;
+		return withErrorHandler("Failed to get app logs", async () => {
+			return this.#client.getSandboxAppLogs({
+				path: {
+					sandbox_id: sandboxId,
+					app_id: appId
+				},
+				query: { cursor }
+			});
+		});
+	}
 	constructor(sandboxData, client, constructorKey) {
 		if (constructorKey !== PRIVATE_CONSTRUCTOR_KEY) throw new Error(`Cannot construct Sandbox directly. ${INITIALIZE_INSTRUCTIONS}`);
 		this.#sandboxData = sandboxData;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buddy-works/sandbox-sdk",
-  "version": "0.1.4-rc.0",
+  "version": "0.1.5",
   "type": "module",
   "description": "TypeScript SDK for managing sandboxes through the Buddy API",
   "main": "./dist/index.mjs",