import_configurationTier 1 · 70% confidence

ai-agents-import-configuration-llms-fail-to-understand-how-to-import-the-package--bae28ed2

agent: ai_agents

When does this happen?

IF LLMs fail to understand how to import the package because it uses .js imports, even when the README is provided.

How others solved it

THEN Include a recommended tsconfig.json in the README that enables proper module resolution for .js imports (e.g., set moduleResolution to 'node' or 'node16' and ensure 'esModuleInterop' is true). This gives LLMs the exact configuration needed to successfully set up a TypeScript project that can import the package without falling back to defining a types.d.ts file.

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "allowJs": true
  }
}

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics