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

package/README.md

@@ -45,6 +45,56 @@ 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"],
+    timeout: 600, // auto-stop after 10 minutes of inactivity
+});
+
+// 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);
+```
+
+## Fetching repositories and artifacts
+
+Use `fetch` to clone repositories or download artifacts into the sandbox on
+first boot. Each entry sets a `type` (`PROJECT_REPO`, `PUBLIC_REPO`, or
+`ARTIFACT`) plus the fields relevant to it.
+
+```typescript
+await Sandbox.create({
+    identifier: "my-sandbox",
+    fetch: [
+        {
+            type: "PUBLIC_REPO",
+            repository: "https://github.com/octocat/Hello-World",
+            ref: "master",
+            path: "/workspace/hello",
+            build_command: "echo built",
+        },
+    ],
+});
+```
+
 ## Regions
 
 Configure the API region:

package/dist/index.d.mts

@@ -10,7 +10,7 @@ type GroupPermissionView = {
   /**
        * The access level for the group
        */
-  access_level?: "DENIED" | "READ_ONLY" | "BLIND" | "RUN_ONLY" | "READ_WRITE" | "MANAGE" | "DEFAULT" | "ALLOWED" | "STAGE" | "COMMIT" | "USE_ONLY";
+  access_level?: "DENIED" | "READ_ONLY" | "USE_ONLY" | "BLIND" | "RUN_ONLY" | "READ_WRITE" | "MANAGE" | "DEFAULT" | "ALLOWED" | "STAGE" | "COMMIT";
 };
 type UserPermissionView = {
   /**
@@ -20,7 +20,24 @@ type UserPermissionView = {
   /**
        * The access level for the user
        */
-  access_level?: "DENIED" | "READ_ONLY" | "BLIND" | "RUN_ONLY" | "READ_WRITE" | "MANAGE" | "DEFAULT" | "ALLOWED" | "STAGE" | "COMMIT" | "USE_ONLY";
+  access_level?: "DENIED" | "READ_ONLY" | "USE_ONLY" | "BLIND" | "RUN_ONLY" | "READ_WRITE" | "MANAGE" | "DEFAULT" | "ALLOWED" | "STAGE" | "COMMIT";
+};
+/**
+ * Access permissions configuration
+ */
+type PermissionsView = {
+  /**
+       * Access level for other workspace members
+       */
+  others?: "DENIED" | "READ_ONLY" | "USE_ONLY" | "BLIND" | "RUN_ONLY" | "READ_WRITE" | "MANAGE" | "DEFAULT" | "ALLOWED" | "STAGE" | "COMMIT";
+  /**
+       * List of specific users with their access levels
+       */
+  users?: Array<UserPermissionView>;
+  /**
+       * List of user groups with their access levels
+       */
+  groups?: Array<GroupPermissionView>;
 };
 type IdsView = {
   /**
@@ -48,17 +65,37 @@ type IdsView = {
        */
   environment_id?: string;
   /**
-       * The ID of the package
+       * The ID of the artifact
        */
-  pkg_id?: string;
+  artifact_id?: string;
   /**
-       * The ID of the package version
+       * The ID of the artifact version
        */
-  pkg_version_id?: string;
+  artifact_version_id?: string;
   /**
        * The ID of the sandbox
        */
   sandbox_id?: string;
+  /**
+       * The ID of the unit test suite
+       */
+  unit_test_suite_id?: string;
+  /**
+       * The ID of the visual test suite
+       */
+  visual_test_suite_id?: string;
+  /**
+       * The ID of the crawl suite
+       */
+  crawl_suite_id?: string;
+  /**
+       * The ID of the distribution
+       */
+  distribution_id?: string;
+  /**
+       * The ID of the route
+       */
+  route_id?: string;
 };
 /**
  * Sandbox reference
@@ -88,6 +125,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 +157,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" | "NPM_REGISTRY" | "ANTHROPIC";
   /**
        * The authentication method used by the integration
        */
@@ -271,23 +312,6 @@ type ProjectView = {
        */
   without_repository?: boolean;
 };
-/**
- * Access permissions configuration
- */
-type PermissionsView = {
-  /**
-       * Access level for other workspace members
-       */
-  others?: "DENIED" | "READ_ONLY" | "BLIND" | "RUN_ONLY" | "READ_WRITE" | "MANAGE" | "DEFAULT" | "ALLOWED" | "STAGE" | "COMMIT" | "USE_ONLY";
-  /**
-       * List of specific users with their access levels
-       */
-  users?: Array<UserPermissionView>;
-  /**
-       * List of user groups with their access levels
-       */
-  groups?: Array<GroupPermissionView>;
-};
 /**
  * The TLS/SSL encryption settings of the tunnel
  */
@@ -336,9 +360,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 +374,9 @@ type HttpSettingsView = {
   /**
        * Custom HTTP headers to add to responses
        */
-  response_headers?: Array<{
+  response_headers?: {
     [key: string]: string;
-  }>;
+  };
   /**
        * Basic authentication username
        */
@@ -410,6 +434,46 @@ type TunnelView = {
        */
   endpoint_url?: string;
 };
+type SandboxFetchView = {
+  /**
+       * The type of the fetch item: PROJECT_REPO, PUBLIC_REPO, or ARTIFACT
+       */
+  type?: "PROJECT_REPO" | "PUBLIC_REPO" | "ARTIFACT";
+  /**
+       * The URL of the git repository (for PUBLIC_REPO type)
+       */
+  repository?: string;
+  /**
+       * The branch, tag, or commit to checkout. Defaults to the default branch
+       */
+  ref?: string;
+  /**
+       * The target path where the item will be cloned/downloaded. Defaults to the app directory
+       */
+  path?: string;
+  /**
+       * The command to run after fetching
+       */
+  build_command?: string;
+  /**
+       * The artifact identifier in format pkg:version (for ARTIFACT type)
+       */
+  artifact?: 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 +560,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 +583,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 +611,6 @@ type ExecuteSandboxCommandRequest = {
        */
   runtime?: "BASH" | "JAVASCRIPT" | "TYPESCRIPT" | "PYTHON";
 };
-/**
- * The list of variables you can use the action
- */
 type EnvironmentVariableView = {
   /**
        * The ID of the variable
@@ -566,15 +653,15 @@ type EnvironmentVariableView = {
        */
   defaults?: string;
   /**
-       * Specifies where to copy the file on each run. Set if `type` is `SSH_KEY`
+       * Specifies where to copy the file on each run. Set if `type` is `FILE`, `SSH_KEY`, `SSH_PUBLIC_KEY`, `IOS_KEYCHAIN`, or `IOS_PROVISION_PROFILES`
        */
   file_path?: string;
   /**
-       * File permission set on copy to a container on each run. Set if `type` is `SSH_KEY`
+       * File permission set on copy to a container on each run. Set if `type` is `FILE`, `SSH_KEY`, `SSH_PUBLIC_KEY`, `IOS_KEYCHAIN`, or `IOS_PROVISION_PROFILES`
        */
   file_chmod?: string;
   /**
-       * Set if `type` is `SSH_KEY`. If it's `NONE`, the variable can be used as a parameter in an action. For `CONTAINER`, the given key is additionally copied to an action container on each run
+       * Set if `type` is `FILE`, `SSH_KEY`, `SSH_PUBLIC_KEY`, `IOS_KEYCHAIN`, or `IOS_PROVISION_PROFILES`. If it's `NONE`, the variable can be used as a parameter in an action. For `CONTAINER`, the given key is additionally copied to an action container on each run
        */
   file_place?: "NONE" | "CONTAINER";
   /**
@@ -602,9 +689,13 @@ type EnvironmentVariableView = {
        */
   passphrase?: string;
   /**
-       * GPG key identifier
+       * Key identifier for iOS certificates, provisioning profiles, or GPG keys
        */
   key_identifier?: string;
+  /**
+       * Set to `true` to disable the variable. Disabled variables are not injected anywhere
+       */
+  disabled?: boolean;
 };
 type CloneSandboxRequest = {
   /**
@@ -645,6 +736,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,41 +749,45 @@ 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 list of items (repositories and artifacts) to fetch into the sandbox
        */
-  tags?: Array<string>;
+  fetch?: Array<SandboxFetchView>;
   /**
-       * The current application status of the sandbox
+       * The timeout in seconds after which the sandbox will be automatically stopped
        */
-  app_status?: "NONE" | "RUNNING" | "ENDED" | "FAILED";
+  timeout?: number;
   /**
-       * The boot logs of the sandbox
+       * The list of tags associated with the sandbox
        */
-  boot_logs?: Array<string>;
+  tags?: Array<string>;
   /**
-       * The current setup status of the sandbox
+       * The boot logs of the sandbox
        */
-  setup_status?: "INPROGRESS" | "SUCCESS" | "FAILED";
+  boot_logs?: Array<string>;
   /**
        * The tunnel endpoints of the sandbox
        */
   endpoints?: Array<TunnelView>;
+  /**
+       * The SSH hostname
+       */
+  ssh_host?: string;
+  /**
+       * The SSH port
+       */
+  ssh_port?: number;
   project?: ProjectView;
   permissions?: PermissionsView;
   /**
@@ -733,15 +832,15 @@ type AddVariableInObjectRequestWritable = {
        */
   defaults?: string;
   /**
-       * Specifies where to copy the file on each run. Set if `type` is `SSH_KEY`
+       * Specifies where to copy the file on each run. Set if `type` is `FILE`, `SSH_KEY`, `SSH_PUBLIC_KEY`, `IOS_KEYCHAIN`, or `IOS_PROVISION_PROFILES`
        */
   file_path?: string;
   /**
-       * File permission set on copy to a container on each run. Set if `type` is `SSH_KEY`
+       * File permission set on copy to a container on each run. Set if `type` is `FILE`, `SSH_KEY`, `SSH_PUBLIC_KEY`, `IOS_KEYCHAIN`, or `IOS_PROVISION_PROFILES`
        */
   file_chmod?: string;
   /**
-       * Set if `type` is `SSH_KEY`. If it's `NONE`, the variable can be used as a parameter in an action. For `CONTAINER`, the given key is additionally copied to an action container on each run
+       * Set if `type` is `FILE`, `SSH_KEY`, `SSH_PUBLIC_KEY`, `IOS_KEYCHAIN`, or `IOS_PROVISION_PROFILES`. If it's `NONE`, the variable can be used as a parameter in an action. For `CONTAINER`, the given key is additionally copied to an action container on each run
        */
   file_place?: "NONE" | "CONTAINER";
   /**
@@ -753,9 +852,13 @@ type AddVariableInObjectRequestWritable = {
        */
   passphrase?: string;
   /**
-       * GPG key identifier
+       * Key identifier for iOS certificates, provisioning profiles, or GPG keys
        */
   key_identifier?: string;
+  /**
+       * Set to `true` to disable the variable. Disabled variables are not injected anywhere
+       */
+  disabled?: boolean;
   /**
        * The type of the added variable
        */
@@ -805,9 +908,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 +922,9 @@ type HttpSettingsViewWritable = {
   /**
        * Custom HTTP headers to add to responses
        */
-  response_headers?: Array<{
+  response_headers?: {
     [key: string]: string;
-  }>;
+  };
   /**
        * Basic authentication username
        */
@@ -897,21 +1000,21 @@ 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
+       * The commands to run during first boot of the sandbox
        */
-  install_commands?: string;
-  /**
-       * The run command 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
+       */
+  apps?: Array<string>;
+  /**
+       * The list of items (repositories and artifacts) to fetch into the sandbox
        */
-  app_type?: "CMD" | "SERVICE";
+  fetch?: Array<SandboxFetchView>;
   /**
        * The list of tags associated with the sandbox
        */
@@ -924,6 +1027,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 +1055,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
        */
@@ -997,17 +1101,45 @@ type GetIdentifiersData = {
              */
     environment?: string;
     /**
-             * The human-readable ID of the package
+             * The human-readable ID of the artifact
              */
-    package?: string;
+    artifact?: string;
     /**
-             * The version of the package
+             * The version of the artifact
              */
-    package_version?: string;
+    artifact_version?: string;
     /**
              * The human-readable ID of the sandbox
              */
     sandbox?: string;
+    /**
+             * The human-readable ID of the unit test suite
+             */
+    unit_test_suite?: string;
+    /**
+             * The human-readable ID of the visual test suite
+             */
+    visual_test_suite?: string;
+    /**
+             * The human-readable ID of the crawl suite
+             */
+    crawl_suite?: string;
+    /**
+             * The human-readable ID of the distribution
+             */
+    distribution?: string;
+    /**
+             * The subdomain of the route. Resolved together with route_domain and route_path against the parent distribution.
+             */
+    route_subdomain?: string;
+    /**
+             * The domain of the route. Required to resolve a route.
+             */
+    route_domain?: string;
+    /**
+             * The path of the route. Resolved together with route_subdomain and route_domain against the parent distribution.
+             */
+    route_path?: string;
   };
   url: "/workspaces/{workspace_domain}/identifiers";
 };
@@ -1077,6 +1209,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 +1604,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 +1925,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 +1971,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 };