chore: sync main with public/main

github-actions[bot] · github-actions[bot] · commit 02749327df3d · 2026-04-24T00:22:42.000Z
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,30 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.10.0] - 2026-04-23
+
+### Added
+- feat: upgrade agent inspector to 0.2.1 (#937) (b49a06f)
+- feat: remove deployed/local from status legend (#936) (c0d5b7b)
+- feat: add GovCloud multi-partition support (#908) (098b104)
+- feat: support preview releases from feature branches (#905) (1a93f92)
+- feat: add AG-UI (AGUI) as fourth first-class protocol mode (#858) (52144dc)
+- feat: add session filesystem storage support (#893) (b97e337)
+
+### Fixed
+- fix: agentcore add component opens component wizard directly (#896) (74a35cb)
+- fix: propagate sessionId as A2A contextId in Inspector proxy (#892) (08d452e)
+
+### Documentation
+- docs: update vended AGENTS.md, README.md, and llm-context references (#898) (84a6dde)
+
+### Other Changes
+- fix(deploy): honor aws-targets.json region for all SDK and CDK calls (#925) (1903f7d)
+- fix(invoke): show full session ID and print resume command on exit (#904) (ce683c0)
+- chore: remove preview bump type from release workflow (#847) (13f16d3)
+- chore: remove single-commit-must-match-PR-title validation (#897) (4d7da2f)
+- fix(invoke): pass session ID to local invoke log files (#894) (e966cb6)
+
 ## [0.9.1] - 2026-04-17
 
 ## [0.9.0] - 2026-04-17
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@aws/agentcore",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "CLI for Amazon Bedrock AgentCore",
   "license": "Apache-2.0",
   "repository": {
@@ -86,7 +86,7 @@
     "@aws-sdk/client-sts": "^3.893.0",
     "@aws-sdk/client-xray": "^3.1003.0",
     "@aws-sdk/credential-providers": "^3.893.0",
-    "@aws/agent-inspector": "0.1.0",
+    "@aws/agent-inspector": "0.2.1",
     "@commander-js/extra-typings": "^14.0.0",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/otlp-transformer": "^0.213.0",
diff --git a/schemas/agentcore.schema.v1.json b/schemas/agentcore.schema.v1.json
@@ -142,7 +142,7 @@
           },
           "protocol": {
             "type": "string",
-            "enum": ["HTTP", "MCP", "A2A"]
+            "enum": ["HTTP", "MCP", "A2A", "AGUI"]
           },
           "requestHeaderAllowlist": {
             "maxItems": 20,
@@ -280,6 +280,27 @@
               }
             },
             "additionalProperties": false
+          },
+          "filesystemConfigurations": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "sessionStorage": {
+                  "type": "object",
+                  "properties": {
+                    "mountPath": {
+                      "type": "string",
+                      "pattern": "^\\/mnt\\/[^/]+$"
+                    }
+                  },
+                  "required": ["mountPath"],
+                  "additionalProperties": false
+                }
+              },
+              "required": ["sessionStorage"],
+              "additionalProperties": false
+            }
           }
         },
         "required": ["name", "build", "entrypoint", "codeLocation"],
diff --git a/src/cli/aws/__tests__/target-region.test.ts b/src/cli/aws/__tests__/target-region.test.ts
@@ -0,0 +1,99 @@
+import { applyTargetRegionToEnv, withTargetRegion } from '../target-region.js';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+
+describe('target-region', () => {
+  let savedRegion: string | undefined;
+  let savedDefaultRegion: string | undefined;
+
+  beforeEach(() => {
+    savedRegion = process.env.AWS_REGION;
+    savedDefaultRegion = process.env.AWS_DEFAULT_REGION;
+    delete process.env.AWS_REGION;
+    delete process.env.AWS_DEFAULT_REGION;
+  });
+
+  afterEach(() => {
+    if (savedRegion !== undefined) process.env.AWS_REGION = savedRegion;
+    else delete process.env.AWS_REGION;
+    if (savedDefaultRegion !== undefined) process.env.AWS_DEFAULT_REGION = savedDefaultRegion;
+    else delete process.env.AWS_DEFAULT_REGION;
+  });
+
+  describe('applyTargetRegionToEnv', () => {
+    it('sets AWS_REGION and AWS_DEFAULT_REGION to the provided region', () => {
+      applyTargetRegionToEnv('ap-southeast-2');
+      expect(process.env.AWS_REGION).toBe('ap-southeast-2');
+      expect(process.env.AWS_DEFAULT_REGION).toBe('ap-southeast-2');
+    });
+
+    it('returns a restore function that clears env vars when they were previously unset', () => {
+      const restore = applyTargetRegionToEnv('eu-west-1');
+      restore();
+      expect(process.env.AWS_REGION).toBeUndefined();
+      expect(process.env.AWS_DEFAULT_REGION).toBeUndefined();
+    });
+
+    it('returns a restore function that restores previous env var values', () => {
+      process.env.AWS_REGION = 'us-east-1';
+      process.env.AWS_DEFAULT_REGION = 'us-east-1';
+
+      const restore = applyTargetRegionToEnv('ap-south-1');
+      expect(process.env.AWS_REGION).toBe('ap-south-1');
+      expect(process.env.AWS_DEFAULT_REGION).toBe('ap-south-1');
+
+      restore();
+      expect(process.env.AWS_REGION).toBe('us-east-1');
+      expect(process.env.AWS_DEFAULT_REGION).toBe('us-east-1');
+    });
+
+    it('restores each env var independently (only one was previously set)', () => {
+      process.env.AWS_REGION = 'us-west-2';
+      // AWS_DEFAULT_REGION intentionally left unset
+
+      const restore = applyTargetRegionToEnv('eu-central-1');
+      expect(process.env.AWS_REGION).toBe('eu-central-1');
+      expect(process.env.AWS_DEFAULT_REGION).toBe('eu-central-1');
+
+      restore();
+      expect(process.env.AWS_REGION).toBe('us-west-2');
+      expect(process.env.AWS_DEFAULT_REGION).toBeUndefined();
+    });
+  });
+
+  describe('withTargetRegion', () => {
+    it('applies region inside the callback and restores afterwards', async () => {
+      let seenRegion: string | undefined;
+      let seenDefaultRegion: string | undefined;
+
+      await withTargetRegion('ap-northeast-1', () => {
+        seenRegion = process.env.AWS_REGION;
+        seenDefaultRegion = process.env.AWS_DEFAULT_REGION;
+        return Promise.resolve();
+      });
+
+      expect(seenRegion).toBe('ap-northeast-1');
+      expect(seenDefaultRegion).toBe('ap-northeast-1');
+      expect(process.env.AWS_REGION).toBeUndefined();
+      expect(process.env.AWS_DEFAULT_REGION).toBeUndefined();
+    });
+
+    it('restores env vars even when the callback throws', async () => {
+      process.env.AWS_REGION = 'us-east-1';
+
+      await expect(
+        withTargetRegion('sa-east-1', () => {
+          expect(process.env.AWS_REGION).toBe('sa-east-1');
+          return Promise.reject(new Error('boom'));
+        })
+      ).rejects.toThrow('boom');
+
+      expect(process.env.AWS_REGION).toBe('us-east-1');
+      expect(process.env.AWS_DEFAULT_REGION).toBeUndefined();
+    });
+
+    it('returns the callback result', async () => {
+      const result = await withTargetRegion('eu-west-2', () => Promise.resolve(42));
+      expect(result).toBe(42);
+    });
+  });
+});
diff --git a/src/cli/aws/index.ts b/src/cli/aws/index.ts
@@ -2,6 +2,7 @@ export { detectAwsContext, type AwsContext } from './aws-context';
 export { detectAccount, getCredentialProvider } from './account';
 export { getPartition, arnPrefix, dnsSuffix, serviceEndpoint, consoleDomain } from './partition';
 export { detectRegion, type RegionDetectionResult } from './region';
+export { applyTargetRegionToEnv, withTargetRegion } from './target-region';
 export {
   invokeBedrockSync,
   invokeClaude,
diff --git a/src/cli/aws/target-region.ts b/src/cli/aws/target-region.ts
@@ -0,0 +1,55 @@
+/**
+ * Make a deployment target's region authoritative for downstream AWS SDK calls.
+ *
+ * The AWS SDK (and CDK toolkit-lib's internal clients) resolve region from
+ * AWS_REGION / AWS_DEFAULT_REGION when constructed without an explicit `region`
+ * option. aws-targets.json is the user's source of truth for where resources
+ * should be created, so we promote the target's region onto the environment for
+ * the operation and restore any prior values afterwards.
+ *
+ * Without this override, a user with a non-default region in aws-targets.json
+ * but no AWS_DEFAULT_REGION set would see resources created in the SDK's default
+ * region — see https://github.com/aws/agentcore-cli/issues/924.
+ */
+
+type RestoreEnv = () => void;
+
+/**
+ * Set AWS_REGION / AWS_DEFAULT_REGION to `region` and return a restore function.
+ * Callers that cannot wrap their work in a callback (e.g. CLI entrypoints that
+ * span many helpers) should use this, and invoke the returned function in a
+ * `finally` block.
+ */
+export function applyTargetRegionToEnv(region: string): RestoreEnv {
+  const prevRegion = process.env.AWS_REGION;
+  const prevDefaultRegion = process.env.AWS_DEFAULT_REGION;
+
+  process.env.AWS_REGION = region;
+  process.env.AWS_DEFAULT_REGION = region;
+
+  return () => {
+    if (prevRegion === undefined) {
+      delete process.env.AWS_REGION;
+    } else {
+      process.env.AWS_REGION = prevRegion;
+    }
+    if (prevDefaultRegion === undefined) {
+      delete process.env.AWS_DEFAULT_REGION;
+    } else {
+      process.env.AWS_DEFAULT_REGION = prevDefaultRegion;
+    }
+  };
+}
+
+/**
+ * Run `fn` with `region` applied to AWS_REGION / AWS_DEFAULT_REGION, restoring
+ * the prior values on return (including when `fn` throws).
+ */
+export async function withTargetRegion<T>(region: string, fn: () => Promise<T>): Promise<T> {
+  const restore = applyTargetRegionToEnv(region);
+  try {
+    return await fn();
+  } finally {
+    restore();
+  }
+}
diff --git a/src/cli/commands/deploy/actions.ts b/src/cli/commands/deploy/actions.ts
@@ -1,5 +1,6 @@
 import { ConfigIO, SecureCredentials } from '../../../lib';
 import type { AgentCoreMcpSpec, DeployedState } from '../../../schema';
+import { applyTargetRegionToEnv } from '../../aws';
 import { validateAwsCredentials } from '../../aws/account';
 import { createSwitchableIoHost } from '../../cdk/toolkit-lib';
 import {
@@ -48,6 +49,7 @@ const MEMORY_ONLY_NEXT_STEPS = ['agentcore add agent', 'agentcore status'];
 
 export async function handleDeploy(options: ValidatedDeployOptions): Promise<DeployResult> {
   let toolkitWrapper = null;
+  let restoreEnv: (() => void) | null = null;
   const logger = new ExecLogger({ command: 'deploy' });
   const { onProgress } = options;
   let currentStepName = '';
@@ -79,6 +81,10 @@ export async function handleDeploy(options: ValidatedDeployOptions): Promise<Dep
         logPath: logger.getRelativeLogPath(),
       };
     }
+    // Make the resolved target region authoritative for downstream SDK / CDK
+    // calls that don't receive an explicit region option.
+    // See https://github.com/aws/agentcore-cli/issues/924.
+    restoreEnv = applyTargetRegionToEnv(target.region);
     endStep('success');
 
     // Read project spec for gateway information (used later for deploy step name and outputs)
@@ -485,5 +491,6 @@ export async function handleDeploy(options: ValidatedDeployOptions): Promise<Dep
     if (toolkitWrapper) {
       await toolkitWrapper.dispose();
     }
+    restoreEnv?.();
   }
 }
diff --git a/src/cli/operations/deploy/teardown.ts b/src/cli/operations/deploy/teardown.ts
@@ -1,5 +1,6 @@
 import { CONFIG_DIR, ConfigIO } from '../../../lib';
 import type { AwsDeploymentTarget } from '../../../schema';
+import { withTargetRegion } from '../../aws';
 import { CdkToolkitWrapper, silentIoHost } from '../../cdk/toolkit-lib';
 import { type DiscoveredStack, findStack } from '../../cloudformation/stack-discovery';
 import { StackSelectionStrategy } from '@aws-cdk/toolkit-lib';
@@ -60,12 +61,18 @@ export async function destroyTarget(options: DestroyTargetOptions): Promise<void
     ioHost: silentIoHost,
   });
 
-  await toolkit.initialize();
-  await toolkit.destroy({
-    stacks: {
-      strategy: StackSelectionStrategy.PATTERN_MUST_MATCH,
-      patterns: [target.stack.stackName],
-    },
+  // aws-targets.json is authoritative for the destroy region; promote it onto
+  // the env so CDK toolkit-lib's internal SDK clients hit the right region even
+  // when AWS_REGION / AWS_DEFAULT_REGION are unset.
+  // See https://github.com/aws/agentcore-cli/issues/924.
+  await withTargetRegion(target.target.region, async () => {
+    await toolkit.initialize();
+    await toolkit.destroy({
+      stacks: {
+        strategy: StackSelectionStrategy.PATTERN_MUST_MATCH,
+        patterns: [target.stack.stackName],
+      },
+    });
   });
 
   // Clean up deployed-state.json after successful destroy
diff --git a/src/cli/tui/hooks/useCdkPreflight.ts b/src/cli/tui/hooks/useCdkPreflight.ts
