From a96a396e79d361e82e1bd89a3f6314a8e0668bc3 Mon Sep 17 00:00:00 2001
From: A <258483684+la14-1@users.noreply.github.com>
Date: Mon, 23 Feb 2026 21:53:28 -0800
Subject: [PATCH] fix: add Lightsail activation prerequisite to docs and error
 messages (#1850)

- Adds a Prerequisites section to sh/aws/README.md (updated path after
  shell scripts reorganization in #1843) with the Lightsail activation
  URL as the first step
- Surfaces the Lightsail activation URL in createInstance error hints
  for both CLI and REST paths so users get actionable guidance on failure
- Bumps CLI to 0.9.1

Fixes #1838

Agent: issue-fixer

Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
---
 cli/package.json   | 2 +-
 cli/src/aws/aws.ts | 2 ++
 sh/aws/README.md   | 8 +++++++-
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/cli/package.json b/cli/package.json
index 065c5e1a..41ae9bf9 100644
--- a/cli/package.json
+++ b/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/spawn",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "type": "module",
   "bin": {
     "spawn": "cli.js"
diff --git a/cli/src/aws/aws.ts b/cli/src/aws/aws.ts
index d7506045..342364e3 100644
--- a/cli/src/aws/aws.ts
+++ b/cli/src/aws/aws.ts
@@ -733,6 +733,7 @@ export async function createInstance(name: string, tier?: CloudInitTier): Promis
     } catch (err) {
       logError("Failed to create Lightsail instance");
       logWarn("Common issues:");
+      logWarn("  - Lightsail not enabled: visit https://lightsail.aws.amazon.com/ls/webapp/home to activate");
       logWarn("  - Instance limit reached for your account");
       logWarn("  - Bundle unavailable in region");
       logWarn("  - AWS credentials lack Lightsail permissions");
@@ -757,6 +758,7 @@ export async function createInstance(name: string, tier?: CloudInitTier): Promis
     } catch (err) {
       logError("Failed to create Lightsail instance");
       logWarn("Common issues:");
+      logWarn("  - Lightsail not enabled: visit https://lightsail.aws.amazon.com/ls/webapp/home to activate");
       logWarn("  - Instance limit reached for your account");
       logWarn("  - Bundle unavailable in region");
       logWarn("  - Credentials lack lightsail:CreateInstances permission");
diff --git a/sh/aws/README.md b/sh/aws/README.md
index 19290188..433378cb 100644
--- a/sh/aws/README.md
+++ b/sh/aws/README.md
@@ -2,7 +2,13 @@
 
 AWS Lightsail instances via AWS CLI. [AWS Lightsail](https://aws.amazon.com/lightsail/)
 
-> Uses 'ubuntu' user instead of 'root'. Requires AWS CLI installed and configured.
+## Prerequisites
+
+1. **Enable AWS Lightsail** — New AWS accounts must activate Lightsail before first use. Visit the [Lightsail console](https://lightsail.aws.amazon.com/ls/webapp/home) and follow the activation prompt. Without this step, all provisioning commands will fail.
+
+2. **AWS CLI installed and configured** — Run `aws configure` with your Access Key ID and Secret Access Key.
+
+> Uses `ubuntu` user instead of `root`.
 
 ## Agents