@aws/agentcore 1.0.0-preview.8 → 1.0.0-rc.1

package/scripts/check-old-cli.lib.mjs

@@ -1,102 +0,0 @@
-/**
- * Testable detection logic for the old Bedrock AgentCore Starter Toolkit.
- *
- * Each function accepts an `execSyncFn` so callers can inject a mock.
- */
-
-const INSTALLERS = [
-  { cmd: 'pip list', label: 'pip', uninstallCmd: 'pip uninstall bedrock-agentcore-starter-toolkit' },
-  { cmd: 'pipx list', label: 'pipx', uninstallCmd: 'pipx uninstall bedrock-agentcore-starter-toolkit' },
-  { cmd: 'uv tool list', label: 'uv', uninstallCmd: 'uv tool uninstall bedrock-agentcore-starter-toolkit' },
-];
-
-/**
- * Run a package-manager list command and check whether the old toolkit appears.
- * Returns `{ installer, uninstallCmd }` when found, or `null`.
- */
-export function probeInstaller(cmd, label, uninstallCmd, execSyncFn) {
-  try {
-    const output = execSyncFn(cmd);
-    if (/^bedrock-agentcore-starter-toolkit\s/m.test(output)) {
-      return { installer: label, uninstallCmd };
-    }
-  } catch {
-    // Command not found or non-zero exit — ignore.
-  }
-  return null;
-}
-
-/**
- * PATH-based fallback: locate an `agentcore` binary and check whether it's
- * the old Python CLI (which doesn't support --version).
- * Returns `{ installer, uninstallCmd }` when the old CLI is found, or `null`.
- */
-export function probePath(execSyncFn, platform = process.platform) {
-  const whichCmd = platform === 'win32' ? 'where agentcore' : 'command -v agentcore';
-  let binaryPath;
-  try {
-    binaryPath = execSyncFn(whichCmd).trim();
-  } catch {
-    return null; // no agentcore binary on PATH
-  }
-  // Skip binaries installed via npm/node — a broken new CLI install would also
-  // fail --version, and we don't want to block reinstallation.
-  if (/node_modules|[/\\]\.?(?:npm|nvm|fnm)[/\\]/.test(binaryPath)) {
-    return null;
-  }
-  try {
-    execSyncFn('agentcore --version');
-    return null; // --version succeeded — this is the new CLI
-  } catch {
-    // --version failed — likely the old Python CLI
-    return {
-      installer: 'PATH',
-      uninstallCmd: 'pip uninstall bedrock-agentcore-starter-toolkit',
-    };
-  }
-}
-
-/**
- * Probe pip, pipx, and uv for the old toolkit, then fall back to PATH-based
- * detection. Returns an array of matches.
- */
-export function detectOldToolkit(execSyncFn) {
-  const results = [];
-  for (const { cmd, label, uninstallCmd } of INSTALLERS) {
-    const match = probeInstaller(cmd, label, uninstallCmd, execSyncFn);
-    if (match) results.push(match);
-  }
-  // If package-manager queries found nothing, fall back to PATH-based check
-  if (results.length === 0) {
-    const pathMatch = probePath(execSyncFn);
-    if (pathMatch) results.push(pathMatch);
-  }
-  return results;
-}
-
-/**
- * Format a user-facing warning message listing per-installer uninstall commands.
- */
-export function formatWarningMessage(detected) {
-  const yellow = '\x1b[33m';
-  const bold = '\x1b[1m';
-  const reset = '\x1b[0m';
-  const lines = [
-    '',
-    `${bold}${yellow}╔══════════════════════════════════════════════════════════════════╗${reset}`,
-    `${bold}${yellow}║  WARNING: Old Bedrock AgentCore Starter Toolkit detected        ║${reset}`,
-    `${bold}${yellow}╚══════════════════════════════════════════════════════════════════╝${reset}`,
-    '',
-    `${yellow}The old Starter Toolkit CLI uses the same "agentcore" command name.${reset}`,
-    `${yellow}To avoid confusion, please uninstall it:${reset}`,
-    '',
-  ];
-
-  for (const { installer, uninstallCmd } of detected) {
-    lines.push(`${yellow}  ${uninstallCmd}  # installed via ${installer}${reset}`);
-  }
-
-  lines.push('');
-
-  return lines.join('\n');
-}

package/scripts/check-old-cli.mjs

@@ -1,10 +0,0 @@
-import { detectOldToolkit, formatWarningMessage } from './check-old-cli.lib.mjs';
-import { execSync } from 'node:child_process';
-
-if (process.env.AGENTCORE_SKIP_CONFLICT_CHECK === '1') process.exit(0);
-
-const detected = detectOldToolkit(cmd => execSync(cmd, { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] }));
-
-if (detected.length > 0) {
-  console.warn(formatWarningMessage(detected));
-}

package/scripts/copy-assets.mjs

@@ -1,64 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const srcDir = path.join(__dirname, '..', 'src', 'assets');
-const destDir = path.join(__dirname, '..', 'dist', 'assets');
-const inspectorSrcDir = path.join(__dirname, '..', 'node_modules', '@aws', 'agent-inspector', 'dist-assets');
-const inspectorDestDir = path.join(__dirname, '..', 'dist', 'agent-inspector');
-
-/**
- * Recursively copy directory contents, excluding specified files at root level only
- * @param {string} src - Source directory
- * @param {string} dest - Destination directory
- * @param {string[]} excludeAtRoot - Files to exclude only at the root level (e.g., 'AGENTS.md')
- * @param {boolean} isRoot - Whether this is the root level call
- */
-function copyDir(src, dest, excludeAtRoot = [], isRoot = true) {
-  // Create destination directory if it doesn't exist
-  if (!fs.existsSync(dest)) {
-    fs.mkdirSync(dest, { recursive: true });
-  }
-
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    // Skip excluded files only at root level
-    if (isRoot && excludeAtRoot.includes(entry.name)) {
-      continue;
-    }
-
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath, excludeAtRoot, false);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-try {
-  console.log('Copying assets...');
-  copyDir(srcDir, destDir, ['AGENTS.md']);
-  console.log('Assets copied successfully!');
-
-  // Copy @aws/agent-inspector built assets into dist/agent-inspector/ for bundled CLI
-  if (fs.existsSync(inspectorSrcDir)) {
-    console.log('Copying @aws/agent-inspector assets...');
-    copyDir(inspectorSrcDir, inspectorDestDir);
-    console.log('@aws/agent-inspector assets copied successfully!');
-  } else {
-    console.error(
-      'Error: @aws/agent-inspector dist-assets/ not found. Run "npm install" to ensure the package is available.'
-    );
-    process.exit(1);
-  }
-} catch (error) {
-  console.error('Error copying assets:', error);
-  process.exit(1);
-}

package/scripts/generate-schema.mjs

@@ -1,40 +0,0 @@
-/**
- * Generates JSON Schema from the AgentCoreProjectSpec Zod schema.
- * Runs against the compiled dist/ output — must be run after build:lib.
- */
-import { mkdirSync, writeFileSync } from 'fs';
-import { dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-const SCHEMA_VERSION = 'v1';
-
-const outPath = join(__dirname, '..', 'schemas', `agentcore.schema.${SCHEMA_VERSION}.json`);
-
-const z = await import('zod');
-const { AgentCoreProjectSpecSchema } = await import('../dist/schema/schemas/agentcore-project.js');
-
-const schema = z.toJSONSchema(AgentCoreProjectSpecSchema, { target: 'draft-07' });
-
-// Fields with defaults should not be required — Zod's toJSONSchema marks them required anyway.
-// Walk the entire schema tree so nested objects are fixed too.
-function stripDefaultsFromRequired(node) {
-  if (typeof node !== 'object' || node === null) return;
-  if (Array.isArray(node)) {
-    node.forEach(stripDefaultsFromRequired);
-    return;
-  }
-  if (Array.isArray(node.required) && node.properties) {
-    node.required = node.required.filter(field => !('default' in (node.properties[field] ?? {})));
-    if (node.required.length === 0) delete node.required;
-  }
-  for (const value of Object.values(node)) {
-    stripDefaultsFromRequired(value);
-  }
-}
-stripDefaultsFromRequired(schema);
-
-mkdirSync(dirname(outPath), { recursive: true });
-writeFileSync(outPath, JSON.stringify(schema, null, 2) + '\n');
-console.log(`Schema written to ${outPath}`);

package/scripts/run-e2e-local.sh

@@ -1,112 +0,0 @@
-#!/usr/bin/env bash
-# Run E2E tests locally, replicating the GitHub Actions e2e-tests.yml workflow.
-#
-# Required env vars:
-#   E2E_ROLE_ARN    — IAM role ARN to assume (grants access to the test account)
-#   E2E_SECRET_ARN  — Secrets Manager ARN containing ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY
-#
-# Optional env vars:
-#   AWS_REGION      — defaults to us-east-1
-#
-# Usage:
-#   export E2E_ROLE_ARN=arn:aws:iam::<account>:role/<role>
-#   export E2E_SECRET_ARN=arn:aws:secretsmanager:<region>:<account>:secret:<name>
-#   ./scripts/run-e2e-local.sh                          # runs strands-bedrock.test.ts (CI default)
-#   ./scripts/run-e2e-local.sh --all                    # runs the full e2e suite
-#   ./scripts/run-e2e-local.sh e2e-tests/foo.test.ts    # runs a specific test file
-#
-# Prerequisites: aws CLI, node >=20.19, npm, git, uv, jq
-
-set -euo pipefail
-
-ROLE_ARN="${E2E_ROLE_ARN:-}"
-SECRET_ARN="${E2E_SECRET_ARN:-}"
-AWS_REGION="${AWS_REGION:-us-east-1}"
-
-if [[ -z "$ROLE_ARN" ]]; then
-  echo "❌ E2E_ROLE_ARN is not set. Export it before running this script:"
-  echo "   export E2E_ROLE_ARN=arn:aws:iam::<account>:role/<role-name>"
-  exit 1
-fi
-
-if [[ -z "$SECRET_ARN" ]]; then
-  echo "❌ E2E_SECRET_ARN is not set. Export it before running this script:"
-  echo "   export E2E_SECRET_ARN=arn:aws:secretsmanager:<region>:<account>:secret:<name>"
-  exit 1
-fi
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-# ── Parse arguments ────────────────────────────────────────────────────────────
-RUN_ALL=false
-TEST_FILES=()
-for arg in "$@"; do
-  if [[ "$arg" == "--all" ]]; then
-    RUN_ALL=true
-  else
-    TEST_FILES+=("$arg")
-  fi
-done
-
-echo "=== Assuming IAM role ==="
-CREDS=$(aws sts assume-role \
-  --role-arn "$ROLE_ARN" \
-  --role-session-name "local-e2e-$(date +%s)" \
-  --duration-seconds 3600 \
-  --query 'Credentials.[AccessKeyId,SecretAccessKey,SessionToken]' \
-  --output text)
-
-export AWS_ACCESS_KEY_ID=$(echo "$CREDS" | awk '{print $1}')
-export AWS_SECRET_ACCESS_KEY=$(echo "$CREDS" | awk '{print $2}')
-export AWS_SESSION_TOKEN=$(echo "$CREDS" | awk '{print $3}')
-export AWS_REGION
-
-echo "✅ Assumed role successfully"
-
-echo "=== Fetching API keys from Secrets Manager ==="
-SECRET_JSON=$(aws secretsmanager get-secret-value \
-  --secret-id "$SECRET_ARN" \
-  --region "$AWS_REGION" \
-  --query SecretString \
-  --output text)
-
-# Mirror the GitHub workflow: parse-json-secrets maps keys to E2E_<KEY> then
-# the workflow maps them to the bare names the tests expect.
-export ANTHROPIC_API_KEY=$(echo "$SECRET_JSON" | jq -r '.ANTHROPIC_API_KEY // empty')
-export OPENAI_API_KEY=$(echo "$SECRET_JSON"    | jq -r '.OPENAI_API_KEY // empty')
-export GEMINI_API_KEY=$(echo "$SECRET_JSON"    | jq -r '.GEMINI_API_KEY // empty')
-
-echo "✅ Secrets loaded (keys present: $(echo "$SECRET_JSON" | jq -r 'keys | join(", ")')"
-
-echo "=== Setting AWS account env var ==="
-export AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
-echo "✅ AWS_ACCOUNT_ID=$AWS_ACCOUNT_ID  AWS_REGION=$AWS_REGION"
-
-echo "=== Configuring git (required for agentcore create) ==="
-git config --global user.email "ci@local" 2>/dev/null || true
-git config --global user.name "Local E2E"  2>/dev/null || true
-
-cd "$REPO_ROOT"
-
-echo "=== Installing dependencies ==="
-npm ci
-
-echo "=== Building CLI ==="
-npm run build
-
-echo "=== Installing CLI globally ==="
-TARBALL=$(npm pack | tail -1)
-npm install -g "$TARBALL"
-echo "✅ Installed: $(agentcore --version)"
-
-echo "=== Running E2E tests ==="
-if [[ "$RUN_ALL" == "true" ]]; then
-  echo "Running full e2e suite"
-  npx vitest run --project e2e
-elif [[ ${#TEST_FILES[@]} -gt 0 ]]; then
-  echo "Running: ${TEST_FILES[*]}"
-  npx vitest run --project e2e "${TEST_FILES[@]}"
-else
-  echo "Running default: e2e-tests/strands-bedrock.test.ts"
-  npx vitest run --project e2e e2e-tests/strands-bedrock.test.ts
-fi

package/scripts/start-tui-harness.sh

@@ -1,90 +0,0 @@
-#!/usr/bin/env bash
-# ---------------------------------------------------------------------------
-# start-tui-harness.sh
-#
-# Convenience wrapper to build (if needed) and start the TUI harness MCP
-# server over HTTP transport.
-#
-# Usage:
-#   ./scripts/start-tui-harness.sh              # default port 24100
-#   ./scripts/start-tui-harness.sh --port 8080  # custom port
-#
-# The server runs in the foreground so it can be stopped with Ctrl-C.
-# ---------------------------------------------------------------------------
-
-set -euo pipefail
-
-# ---------------------------------------------------------------------------
-# Resolve project root (parent directory of this script's directory)
-# ---------------------------------------------------------------------------
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-# ---------------------------------------------------------------------------
-# Parse optional --port argument (default: 24100)
-# ---------------------------------------------------------------------------
-PORT=24100
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --port)
-      if [[ -z "${2:-}" ]]; then
-        echo "Error: --port requires a value" >&2
-        exit 1
-      fi
-      PORT="$2"
-      shift 2
-      ;;
-    --port=*)
-      PORT="${1#*=}"
-      shift
-      ;;
-    *)
-      echo "Unknown option: $1" >&2
-      echo "Usage: $0 [--port PORT]" >&2
-      exit 1
-      ;;
-  esac
-done
-
-# ---------------------------------------------------------------------------
-# Build the harness bundle if it doesn't exist yet
-# ---------------------------------------------------------------------------
-HARNESS_BUNDLE="$PROJECT_DIR/dist/mcp-harness/index.mjs"
-
-if [[ ! -f "$HARNESS_BUNDLE" ]]; then
-  echo "Harness bundle not found at $HARNESS_BUNDLE"
-  echo "Building with: npm run build:harness ..."
-  (cd "$PROJECT_DIR" && npm run build:harness)
-  echo ""
-fi
-
-# ---------------------------------------------------------------------------
-# Start the HTTP MCP server
-# ---------------------------------------------------------------------------
-echo "=========================================="
-echo "  TUI Harness MCP Server (HTTP transport)"
-echo "=========================================="
-echo ""
-echo "  URL:  http://127.0.0.1:${PORT}/mcp"
-echo ""
-echo "  Add this to your .mcp.json:"
-echo ""
-echo "  {"
-echo "    \"mcpServers\": {"
-echo "      \"tui-harness\": {"
-echo "        \"type\": \"http\","
-echo "        \"url\": \"http://127.0.0.1:${PORT}/mcp\""
-echo "      }"
-echo "    }"
-echo "  }"
-echo ""
-echo "  Press Ctrl-C to stop the server."
-echo "=========================================="
-echo ""
-
-# Export the port so the harness process can read it from the environment
-export MCP_HTTP_PORT="$PORT"
-
-# Run the harness bundle as a foreground process
-exec node "$HARNESS_BUNDLE"