feat: bring harness flows into latest version of cli

.github/workflows/canary.yml

@@ -35,6 +35,12 @@ jobs:
       matrix:
         variant: [Released, Prerelease]
         build: [GA, Preview]
+        # The prerelease channel produces a single tarball (GA and preview builds are
+        # identical post-cutover), so there is no separate prerelease preview artifact.
+        # Released/Preview is kept — it verifies the @preview npm tag stays publishable.
+        exclude:
+          - variant: Prerelease
+            build: Preview
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
@@ -72,7 +78,6 @@ jobs:
             "Released/GA")        SPEC="@aws/agentcore" ;;
             "Released/Preview")   SPEC="@aws/agentcore@preview" ;;
             "Prerelease/GA")      SPEC="${PRERELEASE_BASE_URL}/agentcore-cli-prerelease.tgz" ;;
-            "Prerelease/Preview") SPEC="${PRERELEASE_BASE_URL}/agentcore-cli-prerelease-preview.tgz" ;;
             *) echo "Unknown variant/build combination" >&2; exit 1 ;;
           esac
           echo "Installing: $SPEC"

.github/workflows/e2e-tests-full.yml

@@ -30,7 +30,6 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        cli-build: [preview, ga]
         shard: ['1/5', '2/5', '3/5', '4/5', '5/5']
     steps:
       - uses: actions/checkout@v6
@@ -60,10 +59,8 @@ jobs:
             E2E,${{ secrets.E2E_SECRET_ARN }}
           parse-json-secrets: true
       - run: npm ci
-      - name: Build CLI (${{ matrix.cli-build }})
+      - name: Build CLI
         run: npm run build
-        env:
-          BUILD_PREVIEW: ${{ matrix.cli-build == 'preview' && '1' || '0' }}
       - name: Generate GitHub App Token
         id: app-token
         uses: actions/create-github-app-token@v3
@@ -97,7 +94,7 @@ jobs:
           CDK_REPO: ${{ secrets.CDK_REPO_NAME }}
       - name: Install CLI globally
         run: npm install -g "$(npm pack | tail -1)"
-      - name: Run E2E tests (${{ matrix.cli-build }}, shard ${{ matrix.shard }})
+      - name: Run E2E tests (shard ${{ matrix.shard }})
         env:
           AWS_ACCOUNT_ID: ${{ steps.aws.outputs.account_id }}
           AWS_REGION: ${{ inputs.aws_region || 'us-east-1' }}
@@ -112,8 +109,6 @@ jobs:
           CDP_API_KEY_ID: ${{ env.E2E_CDP_API_KEY_ID }}
           CDP_API_KEY_SECRET: ${{ env.E2E_CDP_API_KEY_SECRET }}
           CDP_WALLET_SECRET: ${{ env.E2E_CDP_WALLET_SECRET }}
-          BUILD_PREVIEW: ${{ matrix.cli-build == 'preview' && '1' || '0' }}
-
         run: npx vitest run --project e2e --shard=${{ matrix.shard }}
   browser-tests:
     runs-on: ubuntu-latest

.github/workflows/e2e-tests.yml

@@ -100,18 +100,16 @@ jobs:
 
       - run: npm ci
 
-      - name: Bundle GA and preview tarballs
+      - name: Bundle tarball
         run: |
           npm run bundle
-          GA_TARBALL=$(ls aws-agentcore-*.tgz | grep -v preview | head -1)
-          PREVIEW_TARBALL=$(ls aws-agentcore-*-preview-*.tgz | head -1)
-          echo "GA_TARBALL=$PWD/$GA_TARBALL" >> "$GITHUB_ENV"
-          echo "PREVIEW_TARBALL=$PWD/$PREVIEW_TARBALL" >> "$GITHUB_ENV"
+          TARBALL=$(ls aws-agentcore-*.tgz | head -1)
+          echo "TARBALL=$PWD/$TARBALL" >> "$GITHUB_ENV"
         env:
           AGENTCORE_CDK_PATH: /tmp/cdk-repo
 
-      - name: Install GA CLI globally
-        run: npm install -g "$GA_TARBALL"
+      - name: Install CLI globally
+        run: npm install -g "$TARBALL"
 
       - name: Detect changed e2e test files
         id: changed
@@ -166,10 +164,7 @@ jobs:
           npx vitest run --project e2e e2e-tests/strands-bedrock.test.ts e2e-tests/payment-strands-bedrock.test.ts ${{
           steps.changed.outputs.ga_extra }}
 
-      - name: Install preview CLI globally
-        run: npm install -g "$PREVIEW_TARBALL"
-
-      - name: Run E2E tests (preview/harness)
+      - name: Run E2E tests (harness)
         env:
           AWS_ACCOUNT_ID: ${{ steps.aws.outputs.account_id }}
           AWS_REGION: ${{ inputs.aws_region || 'us-east-1' }}
@@ -180,5 +175,4 @@ jobs:
           E2E_S3_ACCESS_POINT_ARN: ${{ env.E2E_S3_ACCESS_POINT_ARN }}
           E2E_FILESYSTEM_SUBNET_ID: ${{ env.E2E_FILESYSTEM_SUBNET_ID }}
           E2E_FILESYSTEM_SECURITY_GROUP_ID: ${{ env.E2E_FILESYSTEM_SECURITY_GROUP_ID }}
-          BUILD_PREVIEW: '1'
         run: npx vitest run --project e2e e2e-tests/harness-bedrock.test.ts ${{ steps.changed.outputs.harness_extra }}

.github/workflows/prerelease-tarball.yml

@@ -62,23 +62,16 @@ jobs:
           # Delete existing release if it exists (to update the tarballs)
           gh release delete "$TAG" --yes --cleanup-tag 2>/dev/null || true
 
-          # Create a new pre-release with both tarballs
+          # Create a new pre-release with the tarball
           gh release create "$TAG" \
             "${TARBALL_BASE}.tgz" \
-            "${TARBALL_BASE}-preview.tgz" \
             --title "Prerelease" \
-            --notes "Auto-generated tarballs from the latest commit on main.
+            --notes "Auto-generated tarball from the latest commit on main.
 
           Version: \`${VERSION_SUFFIX}\` (cli-cdk)
 
-          **GA build** (no harness features):
           \`\`\`
           npm install -g https://github.com/aws/agentcore-cli/releases/download/prerelease/${TARBALL_BASE}.tgz
-          \`\`\`
-
-          **Preview build** (harness features enabled):
-          \`\`\`
-          npm install -g https://github.com/aws/agentcore-cli/releases/download/prerelease/${TARBALL_BASE}-preview.tgz
           \`\`\`" \
             --prerelease \
             --target "${{ github.sha }}"

.github/workflows/release-main-and-preview.yml

@@ -377,8 +377,6 @@ jobs:
           echo "Set package.json version to $VERSION for preview publish"
 
       - name: Build package
-        env:
-          BUILD_PREVIEW: '1'
         run: npm run build
 
       - name: Publish to npm

README.md

@@ -167,13 +167,7 @@ clusters of bad outcomes.
 | `resume online-insights` | Resume a paused online insights config                      |
 | `archive insights`       | Delete an insights job on the service + clear local history |
 
-### Harness — `[preview]`
-
-> Harness commands are only available in the preview release of the CLI. Install it with:
->
-> ```bash
-> npm install -g @aws/agentcore@preview
-> ```
+### Harness
 
 A harness bundles a runtime, model, tools, skills, memory, and observability into one declarative config. Use it when
 you want infra without writing agent code.

e2e-tests/harness-e2e-helper.ts

@@ -9,9 +9,7 @@ import { join } from 'node:path';
 import { afterAll, beforeAll, describe, expect, it } from 'vitest';
 
 const hasAws = hasAwsCredentials();
-// Harness features are only available in preview builds (BUILD_PREVIEW=1).
-const isPreviewBuild = process.env.BUILD_PREVIEW === '1';
-const baseCanRun = prereqs.npm && prereqs.git && hasAws && isPreviewBuild;
+const baseCanRun = prereqs.npm && prereqs.git && hasAws;
 
 interface HarnessE2EConfig {
   modelProvider: 'bedrock' | 'open_ai' | 'gemini';
@@ -33,8 +31,7 @@ export function createHarnessE2ESuite(cfg: HarnessE2EConfig) {
   if (!canRun) {
     logger.warn(
       `tests are skipped due to insufficient conditions. ` +
-        `npm=${prereqs.npm}, git=${prereqs.git}, hasAws=${hasAws}, ` +
-        `isPreviewBuild=${isPreviewBuild}, hasRequiredVar=${hasRequiredVar}`
+        `npm=${prereqs.npm}, git=${prereqs.git}, hasAws=${hasAws}, hasRequiredVar=${hasRequiredVar}`
     );
   }
 

esbuild.config.mjs

@@ -52,9 +52,6 @@ await esbuild.build({
   minify: true,
   keepNames: true,
   jsx: 'automatic',
-  define: {
-    __PREVIEW__: process.env.BUILD_PREVIEW === '1' ? 'true' : 'false',
-  },
   // Inject require shim for ESM compatibility with CommonJS dependencies
   banner: {
     js: `import { createRequire } from 'module'; import { fileURLToPath as __ef } from 'url'; import { dirname as __ed } from 'path'; const require = createRequire(import.meta.url); const __filename = __ef(import.meta.url); const __dirname = __ed(__filename);`,

integ-tests/add-remove-harness.test.ts

@@ -4,15 +4,11 @@ import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { afterAll, beforeAll, describe, expect, it } from 'vitest';
 
-// Harness features are only available in preview builds (BUILD_PREVIEW=1).
-// The standard CI build is GA, so skip these tests unless the preview bundle is present.
-const isPreviewBuild = process.env.BUILD_PREVIEW === '1';
-
 async function readHarnessSpec(projectPath: string, harnessName: string) {
   return JSON.parse(await readFile(join(projectPath, `app/${harnessName}/harness.json`), 'utf-8'));
 }
 
-describe.skipIf(!isPreviewBuild)('integration: harness add/remove lifecycle', () => {
+describe('integration: harness add/remove lifecycle', () => {
   let project: TestProject;
   const harnessName = 'TestHarness';
 
@@ -87,7 +83,7 @@ describe.skipIf(!isPreviewBuild)('integration: harness add/remove lifecycle', ()
   });
 });
 
-describe.skipIf(!isPreviewBuild)('integration: harness configuration options', () => {
+describe('integration: harness configuration options', () => {
   let project: TestProject;
 
   beforeAll(async () => {
@@ -167,7 +163,7 @@ describe.skipIf(!isPreviewBuild)('integration: harness configuration options', (
   });
 });
 
-describe.skipIf(!isPreviewBuild)('integration: harness validation errors', () => {
+describe('integration: harness validation errors', () => {
   let project: TestProject;
 
   beforeAll(async () => {
@@ -194,7 +190,7 @@ describe.skipIf(!isPreviewBuild)('integration: harness validation errors', () =>
   });
 });
 
-describe.skipIf(!isPreviewBuild)('integration: create project with harness', () => {
+describe('integration: create project with harness', () => {
   let project: TestProject;
   const harnessName = 'CreateHarness';
 

integ-tests/create-edge-cases.test.ts

@@ -34,13 +34,13 @@ describe.skipIf(!prereqs.npm || !prereqs.git)('integration: create edge cases',
         `Error should mention reserved/conflict: ${json.error}`
       ).toBeTruthy();
 
+      // No agent-path flags -> create defaults to the harness path.
       telemetry.assertMetricEmitted({
         command: 'create',
         exit_reason: 'failure',
         error_name: 'ValidationError',
         error_source: 'user',
-        agent_environment: 'runtime',
-        agent_language: 'python',
+        agent_environment: 'harness',
         has_agent: 'true',
       });
     });
@@ -141,12 +141,11 @@ describe.skipIf(!prereqs.npm || !prereqs.git)('integration: create edge cases',
       expect(json.success).toBe(true);
       expect(json.projectPath).toBeTruthy();
 
+      // No agent-path flags -> create defaults to the harness path.
       telemetry.assertMetricEmitted({
         command: 'create',
         exit_reason: 'success',
-        agent_environment: 'runtime',
-        agent_language: 'python',
-        agent_framework: 'strands',
+        agent_environment: 'harness',
         model_provider: 'bedrock',
         has_agent: 'true',
       });
@@ -197,9 +196,7 @@ describe.skipIf(!prereqs.npm || !prereqs.git)('integration: create edge cases',
   });
 });
 
-const isPreviewBuild = process.env.BUILD_PREVIEW === '1';
-
-describe.skipIf(!isPreviewBuild || !prereqs.npm || !prereqs.git)('integration: create harness project', () => {
+describe.skipIf(!prereqs.npm || !prereqs.git)('integration: create harness project', () => {
   let testDir: string;
   const telemetry = createTelemetryHelper();
 

integ-tests/dev-server.test.ts

@@ -175,9 +175,7 @@ describe('integration: dev server', () => {
   );
 });
 
-const isPreviewBuild = process.env.BUILD_PREVIEW === '1';
-
-describe.skipIf(!isPreviewBuild || !hasNpm || !hasGit || !hasUv)('integration: dev with harness-only project', () => {
+describe.skipIf(!hasNpm || !hasGit || !hasUv)('integration: dev with harness-only project', () => {
   const telemetry = createTelemetryHelper();
   let projectPath: string;
 

integ-tests/json-output.test.ts

@@ -40,14 +40,15 @@ describe('JSON output structure', () => {
       ).toBeTruthy();
     });
 
-    it('missing required options returns error JSON', async () => {
-      // Missing --language, --framework, etc without --no-agent
+    it('bare create (no agent flags) returns harness success JSON', async () => {
+      // Without agent-path flags or --no-agent, create defaults to the harness path
+      // and succeeds rather than erroring on missing agent options.
       const result = await runCLI(['create', '--name', 'ValidName', '--json'], testDir);
 
-      expect(result.exitCode).toBe(1);
+      expect(result.exitCode, `stdout: ${result.stdout}`).toBe(0);
       const json = JSON.parse(result.stdout);
-      expect(json.success).toBe(false);
-      expect(typeof json.error).toBe('string');
+      expect(json.success).toBe(true);
+      expect(typeof json.projectPath).toBe('string');
     });
 
     it('invalid framework returns error JSON', async () => {

package.json

@@ -51,7 +51,6 @@
     "build:lib": "tsc -p tsconfig.build.json",
     "build:cli": "node esbuild.config.mjs",
     "build:assets": "node scripts/copy-assets.mjs",
-    "build:preview": "BUILD_PREVIEW=1 node esbuild.config.mjs",
     "build:harness": "BUILD_HARNESS=1 node esbuild.config.mjs",
     "cli": "npx tsx src/cli/index.ts",
     "typecheck": "tsc --noEmit --incremental",