Alien Platform

The alien-gcp-clients package provides a custom HTTP client designed for making direct calls to Google Cloud Platform (GCP) APIs. Unlike a wrapper around the official Google Cloud SDK, it uses reqwest to perform direct API requests authenticated via JWT-generated Bearer tokens.

Key features include:

• Direct API Access: Uses reqwest for lightweight, direct HTTP communication.
• Token Management: Implements token caching with a 45-minute Time-To-Live (TTL).
• Testability: Uses a trait-based API design, making it compatible with mockall for easy mocking in tests.

Supported GCP Services:

• Cloud Run
• Cloud Storage (GCS)
• Firestore
• Pub/Sub
• IAM
• Artifact Registry
• Cloud Build
• Cloud Scheduler
• Compute Engine
• Resource Manager
• Secret Manager
• Service Usage

The alien-azure-clients package provides a custom HTTP client designed specifically for interacting with Azure APIs. It uses reqwest for making direct API calls and handles Azure token authentication automatically.

Key characteristics:

• Type Safety: Model types are automatically code-generated from official Azure OpenAPI specifications using Progenitor at build time.
• Extensibility: It uses a trait-based API design, making it easy to mock for testing using mockall.
• Supported Services: Includes clients for Container Apps, Blob Containers, Service Bus, Key Vault, Managed Identity, Authorization, Container Registry, VMSS, Load Balancers, Network, Storage Accounts, Table Storage, Managed Disks, and Resources.

The machines namespace in the @alienplatform/platform-api TypeScript SDK provides methods for managing machine deployments and join tokens.

Available operations include:

• listJoinTokens: Retrieve join tokens for a deployment.
• createJoinToken: Generate a new join token.
• rotateJoinToken: Rotate an existing join token.
• revokeJoinToken: Revoke a join token.
• cancelMachineDrain: Cancel a machine drain operation.
• drainMachine: Initiate a machine drain.
• removeMachine: Remove a machine.

The alien-error library provides structured error handling for the Alien platform. Unlike standard error libraries, every error produced by this crate carries machine-readable metadata designed for API responses and automated retry logic.

Key metadata fields include:

• code: A machine-readable error code.
• retryable: A boolean indicating if the operation can be safely retried.
• internal: A boolean flag used to control whether sensitive error details are exposed to external clients or kept internal.
• http_status_code: The appropriate HTTP status code for the error.

The SlackIntegration module allows you to manage the connection between Alien and Slack workspaces. It provides the following operations:

• installUrl: Generates the Slack OAuth consent URL for a specific workspace.
• status: Returns the current Slack installation status for a workspace.
• listChannels: Lists public Slack channels available for the workspace's installation (useful for notification channel pickers).
• setNotificationChannel: Configures which Slack channel receives ai-agent monitor reports.
• uninstall: Uninstalls the Slack integration, revoking the bot token at Slack and deleting the local record.

The Managers API allows you to manage the lifecycle and configuration of private managers within the Alien platform. Available operations include:

• Lifecycle Management: create, delete, update, provision, retry, retrySetup, and cancelSetup.
• Retrieval: get (by ID), list (all managers), getDeployment (internal deployment details), and getManagementConfig.
• Domain & Connectivity: getDomainBinding, updateDomainBinding, generateManagerToken (short-lived JWT for browser → manager communication), and generateManagerBindingToken (deployment-scoped token for remote bindings).
• Diagnostics & Health: listEvents, resolveGcpOAuthProvider, and reportHeartbeat (health status and metrics).

The @alienplatform/platform-api SDK provides a user namespace to manage user-specific data and access. Available operations include:

• listMemberships: List all workspaces the current user has access to.
• getProfile: Get the current user's profile and user-scoped onboarding state.
• updateProfile: Update the current user's profile (display name).
• completeProfileSetup: Complete the required beta intake and profile setup dialog.
• createWorkspace: Create a new workspace (user is automatically added as an admin).
• listGitNamespaces: List all git namespaces (e.g., GitHub installations) the current user has access to.
• syncGitNamespaces: Sync git namespaces from the provider (e.g., fetching GitHub app installations).
• listGitNamespaceRepositories: List repositories accessible through a git namespace.

The alien-commands protocol allows a control plane to invoke code on remote deployments without requiring inbound network connections, open ports, VPNs, or firewall changes. This is achieved through a combination of push and pull dispatch models.

Common Use Cases:

• AI agents sending tool calls to workers in a customer's VPC.
• Data connectors running queries against private databases.
• Dashboards pulling real-time metrics from isolated environments.

The alien-aws-clients crate provides a custom HTTP client designed for making direct calls to AWS APIs. Unlike standard wrappers around the official AWS SDK, this library uses reqwest to perform direct API calls with AWS SigV4 request signing.

Key characteristics:

• Direct API Calls: Uses reqwest and implements SigV4 signing manually.
• Testability: Uses a trait-based API design, making it compatible with mockall for unit testing.
• Compatibility: The library is WASM-compatible.

Supported AWS Services:

• Lambda, S3, DynamoDB, SQS, ECR, IAM, STS, CloudFormation, CodeBuild, EC2, Secrets Manager, EventBridge, ACM, API Gateway V2, AutoScaling, ELBv2, SSM.

The @alienplatform/platform-api TypeScript SDK provides two primary operations for managing and inspecting billing data within a workspace:

1. listAuditLog: Retrieves a list of billing activity entries for the current workspace.
2. getEntitlements: Retrieves the workspace billing entitlements used for product feature gates. This data is sourced from Autumn and served via a workspace billing read model with a stale-cache fallback mechanism.