[BUG] ERR_PACKAGE_PATH_NOT_EXPORTED when importing SDK in CommonJS project

[maximelebastard]

Checks

• I have updated to the lastest minor and patch version of Strands
• I have checked the documentation and this is not expected behavior
• I have searched ./issues and there are no duplicates of my issue

Strands Version

0.1.1

Node.js Version

22.13.0

Operating System

macOS 26.1

Installation Method

npm

Steps to Reproduce

1. Create a new Node.js project without "type": "module" in package.json (CommonJS project)
2. Install Strands SDK: npm install @strands-agents/sdk
3. Create a TypeScript file that imports the SDK: import * as st from "@strands-agents/sdk"
4. Try to run with tsx: npx tsx src/server.ts
5. See error: ERR_PACKAGE_PATH_NOT_EXPORTED: No "exports" main defined

Minimal reproducible example:

package.json:

{
  "name": "test-strands",
  "version": "1.0.0",
  "dependencies": {
    "@strands-agents/sdk": "^0.1.1"
  },
  "devDependencies": {
    "tsx": "^4.21.0"
  }
}

main.ts

import * as st from "@strands-agents/sdk";

console.log("SDK imported successfully");

Run npx tsx src/test.ts

Expected Behavior

The SDK should be importable in both CommonJS and ES Module projects without requiring users to modify their project configuration to "type": "module"

Actual Behavior

Import fails with error:

[ERR_PACKAGE_PATH_NOT_EXPORTED]: No "exports" main defined in /path/to/node_modules/@strands-agents/sdk/package.json

Additional Context

The issue occurs because the SDK's package.json exports configuration only defines "import" paths but not "require" paths for CommonJS compatibility:

"exports": {
  ".": {
    "import": "./dist/src/index.js",
    "types": "./dist/src/index.d.ts"
  }
}

This makes the SDK incompatible with CommonJS projects, which is a common setup for many Node.js applications.

Possible Solution

Add CommonJS support to the exports configuration in package.json:

"exports": {
  ".": {
    "import": "./dist/src/index.js",
    "require": "./dist/src/index.js",
    "types": "./dist/src/index.d.ts"
  },
  "./openai": {
    "import": "./dist/src/models/openai.js",
    "require": "./dist/src/models/openai.js",
    "types": "./dist/src/models/openai.d.ts"
  }
  // ... etc
}

Related Issues

No response

[maximelebastard]

I confirm I was able to reproduce and fix it locally by changing the package.json to this.
However, I'm currently from an environment from where I'm unable to submit a merge request.

As a side note, it looks like the version in the package.json (0.0.1-development) is different from the git tag (0.1.1)

{
  "name": "@strands-agents/sdk",
  "version": "0.0.1-development",
  "description": "TypeScript SDK for Strands Agents framework",
  "main": "dist/src/index.js",
  "module": "dist/src/index.js",
  "types": "dist/src/index.d.ts",
  "type": "module",
  "files": [
    "dist"
  ],
  "exports": {
    ".": {
      "import": "./dist/src/index.js",
      "require": "./dist/src/index.js",
      "types": "./dist/src/index.d.ts"
    },
    "./openai": {
      "import": "./dist/src/models/openai.js",
      "require": "./dist/src/models/openai.js",
      "types": "./dist/src/models/openai.d.ts"
    },
    "./bedrock": {
      "import": "./dist/src/models/bedrock.js",
      "require": "./dist/src/models/bedrock.js",
      "types": "./dist/src/models/bedrock.d.ts"
    },
    "./vended_tools/notebook": {
      "import": "./dist/vended_tools/notebook/index.js",
      "require": "./dist/vended_tools/notebook/index.js",
      "types": "./dist/vended_tools/notebook/index.d.ts"
    },
    "./vended_tools/file_editor": {
      "import": "./dist/vended_tools/file_editor/index.js",
      "require": "./dist/vended_tools/file_editor/index.js",
      "types": "./dist/vended_tools/file_editor/index.d.ts"
    },
    "./vended_tools/http_request": {
      "import": "./dist/vended_tools/http_request/index.js",
      "require": "./dist/vended_tools/http_request/index.js",
      "types": "./dist/vended_tools/http_request/index.d.ts"
    }
  },
  "scripts": {
    "build": "tsc",
    "check": "npm run lint && npm run format && npm run type-check && npm run test:coverage && npm run test:package",
    "clean": "rm -rf node_modules dist package-lock.json",
    "test": "vitest run --project unit-node",
    "test:watch": "vitest --project unit-node",
    "test:coverage": "vitest run --coverage --project unit-node",
    "test:types": "vitest run --project types",
    "test:integ": "vitest run --project integ-node",
    "test:integ:browser": "vitest run --project integ-browser",
    "test:integ:all": "vitest run --project integ-node --project integ-browser",
    "test:browser": "vitest run --project unit-browser",
    "test:browser:install": "npx playwright install --with-deps chromium",
    "test:all": "vitest run --project unit-node --project unit-browser",
    "test:all:coverage": "vitest run --coverage --project unit-node --project unit-browser",
    "test:package": "npm run build && cd test-package && npm install && node verify.js",
    "lint": "eslint src tests_integ vended_tools",
    "lint:fix": "eslint src tests_integ vended_tools --fix",
    "format": "prettier --write src tests_integ vended_tools",
    "format:check": "prettier --check src tests_integ vended_tools",
    "type-check": "tsc --noEmit",
    "type-check:watch": "tsc --noEmit --watch",
    "prepare": "npm run build && husky"
  },
  "keywords": [
    "agents",
    "ai",
    "typescript",
    "sdk",
    "strands"
  ],
  "author": "Strands Agents",
  "license": "Apache-2.0",
  "devDependencies": {
    "@aws-sdk/client-secrets-manager": "^3.943.0",
    "@aws-sdk/credential-providers": "^3.943.0",
    "@types/json-schema": "^7.0.15",
    "@types/node": "^24.6.0",
    "@typescript-eslint/eslint-plugin": "^8.48.1",
    "@typescript-eslint/parser": "^8.0.0",
    "@vitest/browser": "^4.0.15",
    "@vitest/browser-playwright": "^4.0.15",
    "@vitest/coverage-v8": "^4.0.15",
    "eslint": "^9.0.0",
    "eslint-plugin-tsdoc": "^0.5.0",
    "husky": "^9.1.7",
    "playwright": "^1.56.1",
    "prettier": "^3.7.4",
    "tsx": "^4.21.0",
    "typescript": "^5.5.0",
    "vitest": "^4.0.8"
  },
  "engines": {
    "node": ">=20.0.0"
  },
  "repository": {
    "type": "git",
    "url": "https://github.com/strands-agents/sdk-typescript.git"
  },
  "bugs": {
    "url": "https://github.com/strands-agents/sdk-typescript/issues"
  },
  "homepage": "https://github.com/strands-agents/sdk-typescript#readme",
  "dependencies": {
    "@aws-sdk/client-bedrock-runtime": "^3.943.0",
    "@modelcontextprotocol/sdk": "^1.24.2",
    "zod": "^4.1.12"
  },
  "optionalDependencies": {
    "openai": "^6.7.0"
  },
  "overrides": {
    "rollup": "4.52.5"
  }
}

[zastrowm]

Looks like the related documentation for this is at https://nodejs.org/api/packages.html#conditional-exports

Reading those docs, either module-sync or default make the most sense to me, if we're not planning on deploying CJS compiled files.

---

Going forward, we should also consider if we can leverage browser as well: https://nodejs.org/api/packages.html#community-conditions-definitions

[zastrowm]

Fixed with #316, should be fixed in the next release