@computesdk/aws-ecs 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 computesdk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,89 @@
+# @computesdk/aws
+
+AWS ECS Fargate provider for ComputeSDK that enables creating and managing containerized sandboxes on AWS infrastructure.
+
+## Installation
+
+```bash
+npm install @computesdk/aws
+```
+
+## Configuration
+
+The AWS provider requires the following environment variables and AWS resources:
+
+```bash
+# AWS Credentials (or use IAM roles/profiles)
+AWS_ACCESS_KEY_ID=your_access_key
+AWS_SECRET_ACCESS_KEY=your_secret_key
+AWS_REGION=us-east-1
+
+# Required AWS Resources
+AWS_ECS_CLUSTER=your-ecs-cluster
+AWS_TASK_DEFINITION=your-task-definition
+AWS_SUBNETS=subnet-xxx,subnet-yyy,subnet-zzz
+AWS_SECURITY_GROUPS=sg-xxx
+```
+
+## Usage
+
+```typescript
+import { fargate } from '@computesdk/aws';
+
+const provider = fargate({
+  cluster: 'my-ecs-cluster',
+  taskDefinition: 'my-task-definition',
+  subnets: ['subnet-12345', 'subnet-67890'],
+  securityGroups: ['sg-12345'],
+  region: 'us-east-1'
+});
+
+// Create a sandbox (ECS task)
+const sandbox = await provider.sandbox.create({ runtime: 'node' });
+console.log(`Created sandbox: ${sandbox.sandboxId}`);
+
+// Get sandbox by ID
+const retrieved = await provider.sandbox.getById(sandbox.sandboxId);
+
+// List all running sandboxes
+const sandboxes = await provider.sandbox.list();
+
+// Destroy the sandbox
+await provider.sandbox.destroy(sandbox.sandboxId);
+```
+
+## Currently Implemented
+
+### Sandbox Operations
+- **create()** - Creates a new ECS Fargate task
+- **getById()** - Retrieves a specific ECS task by ARN
+- **list()** - Lists all running ECS tasks in the cluster
+- **destroy()** - Stops an ECS task
+
+### Configuration Options
+- **cluster** - ECS cluster name or ARN (required)
+- **taskDefinition** - Task definition family name or ARN (required)
+- **subnets** - VPC subnet IDs for task networking (required)
+- **securityGroups** - Security group IDs for task networking (required)
+- **accessKeyId** - AWS access key (optional - falls back to credential chain)
+- **secretAccessKey** - AWS secret key (optional - falls back to credential chain)
+- **region** - AWS region (optional - defaults to AWS_REGION env var or us-east-1)
+- **assignPublicIp** - Whether to assign public IP (optional - defaults to true)
+- **containerName** - Container name in task definition (optional - defaults to 'sandbox')
+
+## Prerequisites
+
+Before using this provider, you need to set up:
+
+1. **ECS Cluster**: A Fargate-compatible ECS cluster
+2. **Task Definition**: A task definition with your desired container image
+3. **VPC Networking**: Subnets and security groups for task networking
+4. **IAM Permissions**: Appropriate permissions to create/manage ECS tasks
+
+## Notes
+
+- Tasks use AWS Fargate launch type (serverless containers)
+- Container images are specified in the task definition, not at runtime
+- The `runtime` parameter is acknowledged but actual environment depends on task definition
+- Tasks are immediately stopped when destroyed
+- All operations use the AWS SDK v3 for ECS

package/dist/index.d.mts

@@ -0,0 +1,52 @@
+import * as computesdk from 'computesdk';
+
+/**
+ * AWS ECS Fargate Provider - Factory-based Implementation
+ */
+/**
+ * Fargate sandbox interface
+ */
+interface FargateSandbox {
+    taskArn: string;
+    clusterArn: string;
+    taskId: string;
+}
+interface FargateConfig {
+    /** AWS Access Key ID - falls back to AWS_ACCESS_KEY_ID env var or default credential chain */
+    accessKeyId?: string;
+    /** AWS Secret Access Key - falls back to AWS_SECRET_ACCESS_KEY env var or default credential chain */
+    secretAccessKey?: string;
+    /** AWS Region - falls back to AWS_REGION env var */
+    region?: string;
+    /** ECS Cluster name or ARN */
+    cluster: string;
+    /** Task definition family name or ARN */
+    taskDefinition: string;
+    /** VPC Subnet IDs for task networking */
+    subnets: string[];
+    /** Security Group IDs for task networking */
+    securityGroups: string[];
+    /** Whether to assign a public IP (default: true) */
+    assignPublicIp?: boolean;
+    /** Container name in the task definition (default: 'sandbox') */
+    containerName?: string;
+}
+declare const getAndValidateCredentials: (config: FargateConfig) => {
+    region: string;
+    cluster: string;
+    taskDefinition: string;
+    subnets: string[];
+    securityGroups: string[];
+    credentials: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    } | undefined;
+    assignPublicIp: boolean;
+    containerName: string;
+};
+/**
+ * Create an AWS ECS Fargate provider instance using the factory pattern
+ */
+declare const fargate: (config: FargateConfig) => computesdk.Provider<FargateSandbox, any, any>;
+
+export { type FargateConfig, fargate, getAndValidateCredentials };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import * as computesdk from 'computesdk';
+
+/**
+ * AWS ECS Fargate Provider - Factory-based Implementation
+ */
+/**
+ * Fargate sandbox interface
+ */
+interface FargateSandbox {
+    taskArn: string;
+    clusterArn: string;
+    taskId: string;
+}
+interface FargateConfig {
+    /** AWS Access Key ID - falls back to AWS_ACCESS_KEY_ID env var or default credential chain */
+    accessKeyId?: string;
+    /** AWS Secret Access Key - falls back to AWS_SECRET_ACCESS_KEY env var or default credential chain */
+    secretAccessKey?: string;
+    /** AWS Region - falls back to AWS_REGION env var */
+    region?: string;
+    /** ECS Cluster name or ARN */
+    cluster: string;
+    /** Task definition family name or ARN */
+    taskDefinition: string;
+    /** VPC Subnet IDs for task networking */
+    subnets: string[];
+    /** Security Group IDs for task networking */
+    securityGroups: string[];
+    /** Whether to assign a public IP (default: true) */
+    assignPublicIp?: boolean;
+    /** Container name in the task definition (default: 'sandbox') */
+    containerName?: string;
+}
+declare const getAndValidateCredentials: (config: FargateConfig) => {
+    region: string;
+    cluster: string;
+    taskDefinition: string;
+    subnets: string[];
+    securityGroups: string[];
+    credentials: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    } | undefined;
+    assignPublicIp: boolean;
+    containerName: string;
+};
+/**
+ * Create an AWS ECS Fargate provider instance using the factory pattern
+ */
+declare const fargate: (config: FargateConfig) => computesdk.Provider<FargateSandbox, any, any>;
+
+export { type FargateConfig, fargate, getAndValidateCredentials };

package/dist/index.js

@@ -0,0 +1,250 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  fargate: () => fargate,
+  getAndValidateCredentials: () => getAndValidateCredentials
+});
+module.exports = __toCommonJS(index_exports);
+var import_computesdk = require("computesdk");
+var import_client_ecs = require("@aws-sdk/client-ecs");
+var getAndValidateCredentials = (config) => {
+  const region = config.region || process.env?.AWS_REGION || "us-east-1";
+  const cluster = config.cluster;
+  const taskDefinition = config.taskDefinition;
+  const subnets = config.subnets;
+  const securityGroups = config.securityGroups;
+  if (!cluster) {
+    throw new Error("Missing ECS cluster. Provide cluster in config.");
+  }
+  if (!taskDefinition) {
+    throw new Error("Missing ECS task definition. Provide taskDefinition in config.");
+  }
+  if (!subnets || subnets.length === 0) {
+    throw new Error("Missing subnets. Provide at least one subnet in config.");
+  }
+  if (!securityGroups || securityGroups.length === 0) {
+    throw new Error("Missing security groups. Provide at least one security group in config.");
+  }
+  const credentials = config.accessKeyId && config.secretAccessKey ? {
+    accessKeyId: config.accessKeyId,
+    secretAccessKey: config.secretAccessKey
+  } : void 0;
+  return {
+    region,
+    cluster,
+    taskDefinition,
+    subnets,
+    securityGroups,
+    credentials,
+    assignPublicIp: config.assignPublicIp ?? true,
+    containerName: config.containerName || "sandbox"
+  };
+};
+var createECSClient = (config) => {
+  const { region, credentials } = getAndValidateCredentials(config);
+  return new import_client_ecs.ECSClient({
+    region,
+    ...credentials && { credentials }
+  });
+};
+var extractTaskId = (taskArn) => {
+  const parts = taskArn.split("/");
+  return parts[parts.length - 1];
+};
+var fargate = (0, import_computesdk.createProvider)({
+  name: "fargate",
+  methods: {
+    sandbox: {
+      // Collection operations (compute.sandbox.*)
+      create: async (config, options) => {
+        const {
+          cluster,
+          taskDefinition,
+          subnets,
+          securityGroups,
+          assignPublicIp,
+          containerName
+        } = getAndValidateCredentials(config);
+        const client = createECSClient(config);
+        try {
+          const command = new import_client_ecs.RunTaskCommand({
+            cluster,
+            taskDefinition,
+            launchType: "FARGATE",
+            networkConfiguration: {
+              awsvpcConfiguration: {
+                subnets,
+                securityGroups,
+                assignPublicIp: assignPublicIp ? "ENABLED" : "DISABLED"
+              }
+            },
+            // Container overrides for ECS are limited to environment variables, 
+            // memory, CPU, and command - not the image itself
+            ...containerName && {
+              overrides: {
+                containerOverrides: [
+                  {
+                    name: containerName
+                    // Additional container overrides can be added here if needed
+                    // such as environment variables, memory, CPU, etc.
+                  }
+                ]
+              }
+            }
+          });
+          const response = await client.send(command);
+          if (!response.tasks || response.tasks.length === 0) {
+            const failures = response.failures?.map((f) => `${f.reason}: ${f.detail}`).join(", ");
+            throw new Error(`No task created. Failures: ${failures || "unknown"}`);
+          }
+          const task = response.tasks[0];
+          if (!task.taskArn) {
+            throw new Error("Task ARN is undefined in response");
+          }
+          const fargateSandbox = {
+            taskArn: task.taskArn,
+            clusterArn: task.clusterArn || cluster,
+            taskId: extractTaskId(task.taskArn)
+          };
+          return {
+            sandbox: fargateSandbox,
+            sandboxId: task.taskArn
+          };
+        } catch (error) {
+          throw new Error(
+            `Failed to create Fargate sandbox: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      getById: async (config, sandboxId) => {
+        const { cluster } = getAndValidateCredentials(config);
+        const client = createECSClient(config);
+        try {
+          const command = new import_client_ecs.DescribeTasksCommand({
+            cluster,
+            tasks: [sandboxId]
+          });
+          const response = await client.send(command);
+          if (!response.tasks || response.tasks.length === 0) {
+            return null;
+          }
+          const task = response.tasks[0];
+          if (!task.taskArn) {
+            throw new Error("Task ARN is missing from response");
+          }
+          const fargateSandbox = {
+            taskArn: task.taskArn,
+            clusterArn: task.clusterArn || cluster,
+            taskId: extractTaskId(task.taskArn)
+          };
+          return {
+            sandbox: fargateSandbox,
+            sandboxId: task.taskArn
+          };
+        } catch (error) {
+          if (error instanceof Error && (error.message.includes("MISSING") || error.message.includes("not found"))) {
+            return null;
+          }
+          throw new Error(
+            `Failed to get Fargate sandbox: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      list: async (config) => {
+        const { cluster } = getAndValidateCredentials(config);
+        const client = createECSClient(config);
+        try {
+          const listCommand = new import_client_ecs.ListTasksCommand({
+            cluster,
+            desiredStatus: "RUNNING"
+          });
+          const listResponse = await client.send(listCommand);
+          const taskArns = listResponse.taskArns || [];
+          if (taskArns.length === 0) {
+            return [];
+          }
+          const describeCommand = new import_client_ecs.DescribeTasksCommand({
+            cluster,
+            tasks: taskArns
+          });
+          const describeResponse = await client.send(describeCommand);
+          const tasks = describeResponse.tasks || [];
+          const sandboxes = tasks.filter((task) => task.taskArn).map((task) => {
+            const fargateSandbox = {
+              taskArn: task.taskArn,
+              clusterArn: task.clusterArn || cluster,
+              taskId: extractTaskId(task.taskArn)
+            };
+            return {
+              sandbox: fargateSandbox,
+              sandboxId: task.taskArn
+            };
+          });
+          return sandboxes;
+        } catch (error) {
+          throw new Error(
+            `Failed to list Fargate sandboxes: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      destroy: async (config, sandboxId) => {
+        const { cluster } = getAndValidateCredentials(config);
+        const client = createECSClient(config);
+        try {
+          const command = new import_client_ecs.StopTaskCommand({
+            cluster,
+            task: sandboxId,
+            reason: "User requested termination"
+          });
+          await client.send(command);
+        } catch (error) {
+          if (error instanceof Error && (error.message.includes("MISSING") || error.message.includes("not found") || error.message.includes("STOPPED"))) {
+            console.warn(`Fargate destroy warning: Task already stopped or not found`);
+            return;
+          }
+          console.warn(
+            `Fargate destroy warning: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      // Instance operations (minimal stubs - not implemented yet)
+      runCode: async (_sandbox, _code, _runtime) => {
+        throw new Error("Fargate runCode method not implemented yet");
+      },
+      runCommand: async (_sandbox, _command, _args, _options) => {
+        throw new Error("Fargate runCommand method not implemented yet");
+      },
+      getInfo: async (_sandbox) => {
+        throw new Error("Fargate getInfo method not implemented yet");
+      },
+      getUrl: async (_sandbox, _options) => {
+        throw new Error("Fargate getUrl method not implemented yet");
+      }
+    }
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  fargate,
+  getAndValidateCredentials
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * AWS ECS Fargate Provider - Factory-based Implementation\n */\n\nimport { createProvider } from 'computesdk';\nimport type { Runtime, CreateSandboxOptions, RunCommandOptions } from 'computesdk';\nimport {\n  ECSClient,\n  RunTaskCommand,\n  StopTaskCommand,\n  DescribeTasksCommand,\n  ListTasksCommand,\n} from '@aws-sdk/client-ecs';\n\n/**\n * Fargate sandbox interface\n */\ninterface FargateSandbox {\n  taskArn: string;\n  clusterArn: string;\n  taskId: string;\n}\n\nexport interface FargateConfig {\n  /** AWS Access Key ID - falls back to AWS_ACCESS_KEY_ID env var or default credential chain */\n  accessKeyId?: string;\n  /** AWS Secret Access Key - falls back to AWS_SECRET_ACCESS_KEY env var or default credential chain */\n  secretAccessKey?: string;\n  /** AWS Region - falls back to AWS_REGION env var */\n  region?: string;\n  /** ECS Cluster name or ARN */\n  cluster: string;\n  /** Task definition family name or ARN */\n  taskDefinition: string;\n  /** VPC Subnet IDs for task networking */\n  subnets: string[];\n  /** Security Group IDs for task networking */\n  securityGroups: string[];\n  /** Whether to assign a public IP (default: true) */\n  assignPublicIp?: boolean;\n  /** Container name in the task definition (default: 'sandbox') */\n  containerName?: string;\n}\n\nexport const getAndValidateCredentials = (config: FargateConfig) => {\n  const region = config.region || process.env?.AWS_REGION || 'us-east-1';\n  const cluster = config.cluster;\n  const taskDefinition = config.taskDefinition;\n  const subnets = config.subnets;\n  const securityGroups = config.securityGroups;\n\n  if (!cluster) {\n    throw new Error('Missing ECS cluster. Provide cluster in config.');\n  }\n\n  if (!taskDefinition) {\n    throw new Error('Missing ECS task definition. Provide taskDefinition in config.');\n  }\n\n  if (!subnets || subnets.length === 0) {\n    throw new Error('Missing subnets. Provide at least one subnet in config.');\n  }\n\n  if (!securityGroups || securityGroups.length === 0) {\n    throw new Error('Missing security groups. Provide at least one security group in config.');\n  }\n\n  // Build credentials object only if explicitly provided\n  // Otherwise, let the SDK use the default credential chain\n  const credentials = config.accessKeyId && config.secretAccessKey\n    ? {\n        accessKeyId: config.accessKeyId,\n        secretAccessKey: config.secretAccessKey,\n      }\n    : undefined;\n\n  return {\n    region,\n    cluster,\n    taskDefinition,\n    subnets,\n    securityGroups,\n    credentials,\n    assignPublicIp: config.assignPublicIp ?? true,\n    containerName: config.containerName || 'sandbox',\n  };\n};\n\n/**\n * Create an ECS client instance\n */\nconst createECSClient = (config: FargateConfig): ECSClient => {\n  const { region, credentials } = getAndValidateCredentials(config);\n  \n  return new ECSClient({\n    region,\n    ...(credentials && { credentials }),\n  });\n};\n\n/**\n * Extract task ID from task ARN\n * ARN format: arn:aws:ecs:region:account:task/cluster-name/task-id\n */\nconst extractTaskId = (taskArn: string): string => {\n  const parts = taskArn.split('/');\n  return parts[parts.length - 1];\n};\n\n/**\n * Normalize task identifier to full ARN if needed\n */\nconst normalizeTaskArn = (taskId: string, cluster: string, region: string, accountId?: string): string => {\n  if (taskId.startsWith('arn:aws:ecs:')) {\n    return taskId;\n  }\n  // If we don't have account ID, just return the task ID and let AWS resolve it\n  return taskId;\n};\n\n/**\n * Create an AWS ECS Fargate provider instance using the factory pattern\n */\nexport const fargate = createProvider<FargateSandbox, FargateConfig>({\n  name: 'fargate',\n  methods: {\n    sandbox: {\n      // Collection operations (compute.sandbox.*)\n      create: async (config: FargateConfig, options?: CreateSandboxOptions) => {\n        const {\n          cluster,\n          taskDefinition,\n          subnets,\n          securityGroups,\n          assignPublicIp,\n          containerName,\n        } = getAndValidateCredentials(config);\n        \n        const client = createECSClient(config);\n\n        try {\n          // Note: For AWS ECS Fargate, the image is specified in the task definition,\n          // not as a runtime override. The task definition should be pre-configured\n          // with the appropriate image for the desired runtime.\n          // \n          // The options?.runtime parameter is acknowledged but the actual runtime\n          // environment is determined by the pre-configured task definition.\n          \n          const command = new RunTaskCommand({\n            cluster,\n            taskDefinition,\n            launchType: 'FARGATE',\n            networkConfiguration: {\n              awsvpcConfiguration: {\n                subnets,\n                securityGroups,\n                assignPublicIp: assignPublicIp ? 'ENABLED' : 'DISABLED',\n              },\n            },\n            // Container overrides for ECS are limited to environment variables, \n            // memory, CPU, and command - not the image itself\n            ...(containerName && {\n              overrides: {\n                containerOverrides: [\n                  {\n                    name: containerName,\n                    // Additional container overrides can be added here if needed\n                    // such as environment variables, memory, CPU, etc.\n                  },\n                ],\n              },\n            }),\n          });\n\n          const response = await client.send(command);\n\n          if (!response.tasks || response.tasks.length === 0) {\n            const failures = response.failures?.map(f => `${f.reason}: ${f.detail}`).join(', ');\n            throw new Error(`No task created. Failures: ${failures || 'unknown'}`);\n          }\n\n          const task = response.tasks[0];\n          \n          if (!task.taskArn) {\n            throw new Error('Task ARN is undefined in response');\n          }\n\n          const fargateSandbox: FargateSandbox = {\n            taskArn: task.taskArn,\n            clusterArn: task.clusterArn || cluster,\n            taskId: extractTaskId(task.taskArn),\n          };\n\n          return {\n            sandbox: fargateSandbox,\n            sandboxId: task.taskArn,\n          };\n        } catch (error) {\n          throw new Error(\n            `Failed to create Fargate sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      getById: async (config: FargateConfig, sandboxId: string) => {\n        const { cluster } = getAndValidateCredentials(config);\n        const client = createECSClient(config);\n\n        try {\n          const command = new DescribeTasksCommand({\n            cluster,\n            tasks: [sandboxId],\n          });\n\n          const response = await client.send(command);\n\n          if (!response.tasks || response.tasks.length === 0) {\n            return null;\n          }\n\n          const task = response.tasks[0];\n          \n          if (!task.taskArn) {\n            throw new Error('Task ARN is missing from response');\n          }\n\n          const fargateSandbox: FargateSandbox = {\n            taskArn: task.taskArn,\n            clusterArn: task.clusterArn || cluster,\n            taskId: extractTaskId(task.taskArn),\n          };\n\n          return {\n            sandbox: fargateSandbox,\n            sandboxId: task.taskArn,\n          };\n        } catch (error) {\n          // Handle task not found\n          if (error instanceof Error && \n              (error.message.includes('MISSING') || error.message.includes('not found'))) {\n            return null;\n          }\n          throw new Error(\n            `Failed to get Fargate sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      list: async (config: FargateConfig) => {\n        const { cluster } = getAndValidateCredentials(config);\n        const client = createECSClient(config);\n\n        try {\n          // Step 1: List task ARNs\n          const listCommand = new ListTasksCommand({\n            cluster,\n            desiredStatus: 'RUNNING',\n          });\n\n          const listResponse = await client.send(listCommand);\n          const taskArns = listResponse.taskArns || [];\n\n          if (taskArns.length === 0) {\n            return [];\n          }\n\n          // Step 2: Describe tasks to get full details\n          const describeCommand = new DescribeTasksCommand({\n            cluster,\n            tasks: taskArns,\n          });\n\n          const describeResponse = await client.send(describeCommand);\n          const tasks = describeResponse.tasks || [];\n\n          // Transform each task into the expected format\n          const sandboxes = tasks\n            .filter(task => task.taskArn)\n            .map(task => {\n              const fargateSandbox: FargateSandbox = {\n                taskArn: task.taskArn!,\n                clusterArn: task.clusterArn || cluster,\n                taskId: extractTaskId(task.taskArn!),\n              };\n\n              return {\n                sandbox: fargateSandbox,\n                sandboxId: task.taskArn!,\n              };\n            });\n\n          return sandboxes;\n        } catch (error) {\n          throw new Error(\n            `Failed to list Fargate sandboxes: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      destroy: async (config: FargateConfig, sandboxId: string) => {\n        const { cluster } = getAndValidateCredentials(config);\n        const client = createECSClient(config);\n\n        try {\n          const command = new StopTaskCommand({\n            cluster,\n            task: sandboxId,\n            reason: 'User requested termination',\n          });\n\n          await client.send(command);\n        } catch (error) {\n          // For destroy operations, don't throw if task is already stopped/gone\n          if (error instanceof Error && \n              (error.message.includes('MISSING') || \n               error.message.includes('not found') ||\n               error.message.includes('STOPPED'))) {\n            console.warn(`Fargate destroy warning: Task already stopped or not found`);\n            return;\n          }\n          console.warn(\n            `Fargate destroy warning: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      // Instance operations (minimal stubs - not implemented yet)\n      runCode: async (_sandbox: FargateSandbox, _code: string, _runtime?: Runtime) => {\n        throw new Error('Fargate runCode method not implemented yet');\n      },\n\n      runCommand: async (_sandbox: FargateSandbox, _command: string, _args?: string[], _options?: RunCommandOptions) => {\n        throw new Error('Fargate runCommand method not implemented yet');\n      },\n\n      getInfo: async (_sandbox: FargateSandbox) => {\n        throw new Error('Fargate getInfo method not implemented yet');\n      },\n\n      getUrl: async (_sandbox: FargateSandbox, _options: { port: number; protocol?: string }) => {\n        throw new Error('Fargate getUrl method not implemented yet');\n      },\n    },\n  },\n});"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,230 @@
+// src/index.ts
+import { createProvider } from "computesdk";
+import {
+  ECSClient,
+  RunTaskCommand,
+  StopTaskCommand,
+  DescribeTasksCommand,
+  ListTasksCommand
+} from "@aws-sdk/client-ecs";
+var getAndValidateCredentials = (config) => {
+  const region = config.region || process.env?.AWS_REGION || "us-east-1";
+  const cluster = config.cluster;
+  const taskDefinition = config.taskDefinition;
+  const subnets = config.subnets;
+  const securityGroups = config.securityGroups;
+  if (!cluster) {
+    throw new Error("Missing ECS cluster. Provide cluster in config.");
+  }
+  if (!taskDefinition) {
+    throw new Error("Missing ECS task definition. Provide taskDefinition in config.");
+  }
+  if (!subnets || subnets.length === 0) {
+    throw new Error("Missing subnets. Provide at least one subnet in config.");
+  }
+  if (!securityGroups || securityGroups.length === 0) {
+    throw new Error("Missing security groups. Provide at least one security group in config.");
+  }
+  const credentials = config.accessKeyId && config.secretAccessKey ? {
+    accessKeyId: config.accessKeyId,
+    secretAccessKey: config.secretAccessKey
+  } : void 0;
+  return {
+    region,
+    cluster,
+    taskDefinition,
+    subnets,
+    securityGroups,
+    credentials,
+    assignPublicIp: config.assignPublicIp ?? true,
+    containerName: config.containerName || "sandbox"
+  };
+};
+var createECSClient = (config) => {
+  const { region, credentials } = getAndValidateCredentials(config);
+  return new ECSClient({
+    region,
+    ...credentials && { credentials }
+  });
+};
+var extractTaskId = (taskArn) => {
+  const parts = taskArn.split("/");
+  return parts[parts.length - 1];
+};
+var fargate = createProvider({
+  name: "fargate",
+  methods: {
+    sandbox: {
+      // Collection operations (compute.sandbox.*)
+      create: async (config, options) => {
+        const {
+          cluster,
+          taskDefinition,
+          subnets,
+          securityGroups,
+          assignPublicIp,
+          containerName
+        } = getAndValidateCredentials(config);
+        const client = createECSClient(config);
+        try {
+          const command = new RunTaskCommand({
+            cluster,
+            taskDefinition,
+            launchType: "FARGATE",
+            networkConfiguration: {
+              awsvpcConfiguration: {
+                subnets,
+                securityGroups,
+                assignPublicIp: assignPublicIp ? "ENABLED" : "DISABLED"
+              }
+            },
+            // Container overrides for ECS are limited to environment variables, 
+            // memory, CPU, and command - not the image itself
+            ...containerName && {
+              overrides: {
+                containerOverrides: [
+                  {
+                    name: containerName
+                    // Additional container overrides can be added here if needed
+                    // such as environment variables, memory, CPU, etc.
+                  }
+                ]
+              }
+            }
+          });
+          const response = await client.send(command);
+          if (!response.tasks || response.tasks.length === 0) {
+            const failures = response.failures?.map((f) => `${f.reason}: ${f.detail}`).join(", ");
+            throw new Error(`No task created. Failures: ${failures || "unknown"}`);
+          }
+          const task = response.tasks[0];
+          if (!task.taskArn) {
+            throw new Error("Task ARN is undefined in response");
+          }
+          const fargateSandbox = {
+            taskArn: task.taskArn,
+            clusterArn: task.clusterArn || cluster,
+            taskId: extractTaskId(task.taskArn)
+          };
+          return {
+            sandbox: fargateSandbox,
+            sandboxId: task.taskArn
+          };
+        } catch (error) {
+          throw new Error(
+            `Failed to create Fargate sandbox: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      getById: async (config, sandboxId) => {
+        const { cluster } = getAndValidateCredentials(config);
+        const client = createECSClient(config);
+        try {
+          const command = new DescribeTasksCommand({
+            cluster,
+            tasks: [sandboxId]
+          });
+          const response = await client.send(command);
+          if (!response.tasks || response.tasks.length === 0) {
+            return null;
+          }
+          const task = response.tasks[0];
+          if (!task.taskArn) {
+            throw new Error("Task ARN is missing from response");
+          }
+          const fargateSandbox = {
+            taskArn: task.taskArn,
+            clusterArn: task.clusterArn || cluster,
+            taskId: extractTaskId(task.taskArn)
+          };
+          return {
+            sandbox: fargateSandbox,
+            sandboxId: task.taskArn
+          };
+        } catch (error) {
+          if (error instanceof Error && (error.message.includes("MISSING") || error.message.includes("not found"))) {
+            return null;
+          }
+          throw new Error(
+            `Failed to get Fargate sandbox: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      list: async (config) => {
+        const { cluster } = getAndValidateCredentials(config);
+        const client = createECSClient(config);
+        try {
+          const listCommand = new ListTasksCommand({
+            cluster,
+            desiredStatus: "RUNNING"
+          });
+          const listResponse = await client.send(listCommand);
+          const taskArns = listResponse.taskArns || [];
+          if (taskArns.length === 0) {
+            return [];
+          }
+          const describeCommand = new DescribeTasksCommand({
+            cluster,
+            tasks: taskArns
+          });
+          const describeResponse = await client.send(describeCommand);
+          const tasks = describeResponse.tasks || [];
+          const sandboxes = tasks.filter((task) => task.taskArn).map((task) => {
+            const fargateSandbox = {
+              taskArn: task.taskArn,
+              clusterArn: task.clusterArn || cluster,
+              taskId: extractTaskId(task.taskArn)
+            };
+            return {
+              sandbox: fargateSandbox,
+              sandboxId: task.taskArn
+            };
+          });
+          return sandboxes;
+        } catch (error) {
+          throw new Error(
+            `Failed to list Fargate sandboxes: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      destroy: async (config, sandboxId) => {
+        const { cluster } = getAndValidateCredentials(config);
+        const client = createECSClient(config);
+        try {
+          const command = new StopTaskCommand({
+            cluster,
+            task: sandboxId,
+            reason: "User requested termination"
+          });
+          await client.send(command);
+        } catch (error) {
+          if (error instanceof Error && (error.message.includes("MISSING") || error.message.includes("not found") || error.message.includes("STOPPED"))) {
+            console.warn(`Fargate destroy warning: Task already stopped or not found`);
+            return;
+          }
+          console.warn(
+            `Fargate destroy warning: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      // Instance operations (minimal stubs - not implemented yet)
+      runCode: async (_sandbox, _code, _runtime) => {
+        throw new Error("Fargate runCode method not implemented yet");
+      },
+      runCommand: async (_sandbox, _command, _args, _options) => {
+        throw new Error("Fargate runCommand method not implemented yet");
+      },
+      getInfo: async (_sandbox) => {
+        throw new Error("Fargate getInfo method not implemented yet");
+      },
+      getUrl: async (_sandbox, _options) => {
+        throw new Error("Fargate getUrl method not implemented yet");
+      }
+    }
+  }
+});
+export {
+  fargate,
+  getAndValidateCredentials
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * AWS ECS Fargate Provider - Factory-based Implementation\n */\n\nimport { createProvider } from 'computesdk';\nimport type { Runtime, CreateSandboxOptions, RunCommandOptions } from 'computesdk';\nimport {\n  ECSClient,\n  RunTaskCommand,\n  StopTaskCommand,\n  DescribeTasksCommand,\n  ListTasksCommand,\n} from '@aws-sdk/client-ecs';\n\n/**\n * Fargate sandbox interface\n */\ninterface FargateSandbox {\n  taskArn: string;\n  clusterArn: string;\n  taskId: string;\n}\n\nexport interface FargateConfig {\n  /** AWS Access Key ID - falls back to AWS_ACCESS_KEY_ID env var or default credential chain */\n  accessKeyId?: string;\n  /** AWS Secret Access Key - falls back to AWS_SECRET_ACCESS_KEY env var or default credential chain */\n  secretAccessKey?: string;\n  /** AWS Region - falls back to AWS_REGION env var */\n  region?: string;\n  /** ECS Cluster name or ARN */\n  cluster: string;\n  /** Task definition family name or ARN */\n  taskDefinition: string;\n  /** VPC Subnet IDs for task networking */\n  subnets: string[];\n  /** Security Group IDs for task networking */\n  securityGroups: string[];\n  /** Whether to assign a public IP (default: true) */\n  assignPublicIp?: boolean;\n  /** Container name in the task definition (default: 'sandbox') */\n  containerName?: string;\n}\n\nexport const getAndValidateCredentials = (config: FargateConfig) => {\n  const region = config.region || process.env?.AWS_REGION || 'us-east-1';\n  const cluster = config.cluster;\n  const taskDefinition = config.taskDefinition;\n  const subnets = config.subnets;\n  const securityGroups = config.securityGroups;\n\n  if (!cluster) {\n    throw new Error('Missing ECS cluster. Provide cluster in config.');\n  }\n\n  if (!taskDefinition) {\n    throw new Error('Missing ECS task definition. Provide taskDefinition in config.');\n  }\n\n  if (!subnets || subnets.length === 0) {\n    throw new Error('Missing subnets. Provide at least one subnet in config.');\n  }\n\n  if (!securityGroups || securityGroups.length === 0) {\n    throw new Error('Missing security groups. Provide at least one security group in config.');\n  }\n\n  // Build credentials object only if explicitly provided\n  // Otherwise, let the SDK use the default credential chain\n  const credentials = config.accessKeyId && config.secretAccessKey\n    ? {\n        accessKeyId: config.accessKeyId,\n        secretAccessKey: config.secretAccessKey,\n      }\n    : undefined;\n\n  return {\n    region,\n    cluster,\n    taskDefinition,\n    subnets,\n    securityGroups,\n    credentials,\n    assignPublicIp: config.assignPublicIp ?? true,\n    containerName: config.containerName || 'sandbox',\n  };\n};\n\n/**\n * Create an ECS client instance\n */\nconst createECSClient = (config: FargateConfig): ECSClient => {\n  const { region, credentials } = getAndValidateCredentials(config);\n  \n  return new ECSClient({\n    region,\n    ...(credentials && { credentials }),\n  });\n};\n\n/**\n * Extract task ID from task ARN\n * ARN format: arn:aws:ecs:region:account:task/cluster-name/task-id\n */\nconst extractTaskId = (taskArn: string): string => {\n  const parts = taskArn.split('/');\n  return parts[parts.length - 1];\n};\n\n/**\n * Normalize task identifier to full ARN if needed\n */\nconst normalizeTaskArn = (taskId: string, cluster: string, region: string, accountId?: string): string => {\n  if (taskId.startsWith('arn:aws:ecs:')) {\n    return taskId;\n  }\n  // If we don't have account ID, just return the task ID and let AWS resolve it\n  return taskId;\n};\n\n/**\n * Create an AWS ECS Fargate provider instance using the factory pattern\n */\nexport const fargate = createProvider<FargateSandbox, FargateConfig>({\n  name: 'fargate',\n  methods: {\n    sandbox: {\n      // Collection operations (compute.sandbox.*)\n      create: async (config: FargateConfig, options?: CreateSandboxOptions) => {\n        const {\n          cluster,\n          taskDefinition,\n          subnets,\n          securityGroups,\n          assignPublicIp,\n          containerName,\n        } = getAndValidateCredentials(config);\n        \n        const client = createECSClient(config);\n\n        try {\n          // Note: For AWS ECS Fargate, the image is specified in the task definition,\n          // not as a runtime override. The task definition should be pre-configured\n          // with the appropriate image for the desired runtime.\n          // \n          // The options?.runtime parameter is acknowledged but the actual runtime\n          // environment is determined by the pre-configured task definition.\n          \n          const command = new RunTaskCommand({\n            cluster,\n            taskDefinition,\n            launchType: 'FARGATE',\n            networkConfiguration: {\n              awsvpcConfiguration: {\n                subnets,\n                securityGroups,\n                assignPublicIp: assignPublicIp ? 'ENABLED' : 'DISABLED',\n              },\n            },\n            // Container overrides for ECS are limited to environment variables, \n            // memory, CPU, and command - not the image itself\n            ...(containerName && {\n              overrides: {\n                containerOverrides: [\n                  {\n                    name: containerName,\n                    // Additional container overrides can be added here if needed\n                    // such as environment variables, memory, CPU, etc.\n                  },\n                ],\n              },\n            }),\n          });\n\n          const response = await client.send(command);\n\n          if (!response.tasks || response.tasks.length === 0) {\n            const failures = response.failures?.map(f => `${f.reason}: ${f.detail}`).join(', ');\n            throw new Error(`No task created. Failures: ${failures || 'unknown'}`);\n          }\n\n          const task = response.tasks[0];\n          \n          if (!task.taskArn) {\n            throw new Error('Task ARN is undefined in response');\n          }\n\n          const fargateSandbox: FargateSandbox = {\n            taskArn: task.taskArn,\n            clusterArn: task.clusterArn || cluster,\n            taskId: extractTaskId(task.taskArn),\n          };\n\n          return {\n            sandbox: fargateSandbox,\n            sandboxId: task.taskArn,\n          };\n        } catch (error) {\n          throw new Error(\n            `Failed to create Fargate sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      getById: async (config: FargateConfig, sandboxId: string) => {\n        const { cluster } = getAndValidateCredentials(config);\n        const client = createECSClient(config);\n\n        try {\n          const command = new DescribeTasksCommand({\n            cluster,\n            tasks: [sandboxId],\n          });\n\n          const response = await client.send(command);\n\n          if (!response.tasks || response.tasks.length === 0) {\n            return null;\n          }\n\n          const task = response.tasks[0];\n          \n          if (!task.taskArn) {\n            throw new Error('Task ARN is missing from response');\n          }\n\n          const fargateSandbox: FargateSandbox = {\n            taskArn: task.taskArn,\n            clusterArn: task.clusterArn || cluster,\n            taskId: extractTaskId(task.taskArn),\n          };\n\n          return {\n            sandbox: fargateSandbox,\n            sandboxId: task.taskArn,\n          };\n        } catch (error) {\n          // Handle task not found\n          if (error instanceof Error && \n              (error.message.includes('MISSING') || error.message.includes('not found'))) {\n            return null;\n          }\n          throw new Error(\n            `Failed to get Fargate sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      list: async (config: FargateConfig) => {\n        const { cluster } = getAndValidateCredentials(config);\n        const client = createECSClient(config);\n\n        try {\n          // Step 1: List task ARNs\n          const listCommand = new ListTasksCommand({\n            cluster,\n            desiredStatus: 'RUNNING',\n          });\n\n          const listResponse = await client.send(listCommand);\n          const taskArns = listResponse.taskArns || [];\n\n          if (taskArns.length === 0) {\n            return [];\n          }\n\n          // Step 2: Describe tasks to get full details\n          const describeCommand = new DescribeTasksCommand({\n            cluster,\n            tasks: taskArns,\n          });\n\n          const describeResponse = await client.send(describeCommand);\n          const tasks = describeResponse.tasks || [];\n\n          // Transform each task into the expected format\n          const sandboxes = tasks\n            .filter(task => task.taskArn)\n            .map(task => {\n              const fargateSandbox: FargateSandbox = {\n                taskArn: task.taskArn!,\n                clusterArn: task.clusterArn || cluster,\n                taskId: extractTaskId(task.taskArn!),\n              };\n\n              return {\n                sandbox: fargateSandbox,\n                sandboxId: task.taskArn!,\n              };\n            });\n\n          return sandboxes;\n        } catch (error) {\n          throw new Error(\n            `Failed to list Fargate sandboxes: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      destroy: async (config: FargateConfig, sandboxId: string) => {\n        const { cluster } = getAndValidateCredentials(config);\n        const client = createECSClient(config);\n\n        try {\n          const command = new StopTaskCommand({\n            cluster,\n            task: sandboxId,\n            reason: 'User requested termination',\n          });\n\n          await client.send(command);\n        } catch (error) {\n          // For destroy operations, don't throw if task is already stopped/gone\n          if (error instanceof Error && \n              (error.message.includes('MISSING') || \n               error.message.includes('not found') ||\n               error.message.includes('STOPPED'))) {\n            console.warn(`Fargate destroy warning: Task already stopped or not found`);\n            return;\n          }\n          console.warn(\n            `Fargate destroy warning: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      // Instance operations (minimal stubs - not implemented yet)\n      runCode: async (_sandbox: FargateSandbox, _code: string, _runtime?: Runtime) => {\n        throw new Error('Fargate runCode method not implemented yet');\n      },\n\n      runCommand: async (_sandbox: FargateSandbox, _command: string, _args?: string[], _options?: RunCommandOptions) => {\n        throw new Error('Fargate runCommand method not implemented yet');\n      },\n\n      getInfo: async (_sandbox: FargateSandbox) => {\n        throw new Error('Fargate getInfo method not implemented yet');\n      },\n\n      getUrl: async (_sandbox: FargateSandbox, _options: { port: number; protocol?: string }) => {\n        throw new Error('Fargate getUrl method not implemented yet');\n      },\n    },\n  },\n});"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@computesdk/aws-ecs",
+  "version": "1.0.1",
+  "description": "AWS ECS provider for ComputeSDK",
+  "author": "ComputeSDK Team",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@aws-sdk/client-ecs": "^3.943.0",
+    "computesdk": "1.8.8"
+  },
+  "keywords": [
+    "aws",
+    "sandbox",
+    "code-execution",
+    "cloud",
+    "compute",
+    "containers",
+    "ecs"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/computesdk/computesdk.git",
+    "directory": "packages/aws-ecs"
+  },
+  "homepage": "https://github.com/computesdk/computesdk/tree/main/packages/aws-ecs",
+  "bugs": {
+    "url": "https://github.com/computesdk/computesdk/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.37.0",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0",
+    "@computesdk/test-utils": "1.4.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint"
+  }
+}