Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

bug: agentcore package fails for TypeScript because esbuild is bundled

Abierto
#2,125 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
3/5
Tiempo estimado
1-2 días
Aptitud para principiantes
78/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
typescript
Área
build-system, cli

Línea de trabajo

Comienza con esbuild.config.mjs y el manifiesto del paquete para rastrear cómo la CLI empaqueta e instala esbuild. Revisa los cambios en npm-shrinkwrap.json y amplía la prueba smoke existente del tarball instalado con el fixture mínimo de TypeScript descrito aquí. La tarea está terminada cuando una instalación limpia npm-packed ejecuta agentcore package y crea el ZIP esperado sin el error de bundling.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

bug
Description

agentcore package fails when packaging a TypeScript CodeZip project because the CLI bundle includes esbuild's JavaScript API.

I encountered this with @aws/agentcore versions 0.27.1 and 0.28.0.

Steps to Reproduce
  1. Use an unmodified npm installation of @aws/[email protected].
  2. Create a minimal project with the following files.

agentcore/agentcore.json:

{
  "name": "PackageTest",
  "version": 1,
  "runtimes": [
    {
      "name": "TestRuntime",
      "build": "CodeZip",
      "entrypoint": "main.ts",
      "codeLocation": "./app/TestRuntime",
      "runtimeVersion": "NODE_22",
      "protocol": "HTTP"
    }
  ]
}

app/TestRuntime/main.ts:

export {};

app/TestRuntime/package.json:

{
  "name": "typescript-package-fixture",
  "version": "1.0.0",
  "private": true
}
  1. From the project root, run:
agentcore package
Expected Behavior

The command successfully bundles the TypeScript entry point and creates agentcore/TestRuntime.zip.

Actual Behavior

Packaging fails with:

The esbuild JavaScript API cannot be bundled.
Please mark the "esbuild" package as external so it's not included in the bundle.
CLI Version

0.28.0

Operating System

macOS

Additional Context

The original environment used Node.js v24.15.0.

In esbuild.config.mjs, esbuild is not listed as an external dependency, so its JavaScript API is bundled into the CLI. TypeScript CodeZip packaging invokes that API at runtime.

Marking esbuild as external alone is insufficient: it is currently a development dependency, so an npm installation of the published CLI does not install it as a direct runtime dependency.

I have prepared a patch that:

  • Marks esbuild as external in the CLI build.
  • Moves esbuild from devDependencies to dependencies, retaining the existing version range and updating npm-shrinkwrap.json.
  • Extends the existing installed-tarball smoke test to package a minimal TypeScript fixture and check that the ZIP is generated.

In a separate clean installation from an npm-packed tarball, the unpatched CLI failed with the error above, while the patched CLI successfully generated the ZIP.

This report concerns local packaging; no AWS deployment is required to reproduce it.

Lenguaje dominante
TypeScript
Estrellas
291
Forks
96
Merge medio
20 h 50 min
PR fusionados (30 d)
214

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de aws/agentcore-cli

Todos los issues de aws/agentcore-cli

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.