@myadbox/field-ai

AI-powered form field text generation service using OpenRouter and LangFuse observability.

Module Format

This package uses CommonJS (not ESM) due to OpenTelemetry SDK limitations.

The @opentelemetry/sdk-node package has documented ESM incompatibilities that cause "not a constructor" errors when running in ESM mode. Until these issues are resolved upstream, the package must remain CommonJS.

Do not add "type": "module" to package.json.

Local Development (Evals)

Running evals locally requires environment variables. Copy .env.example to .env and populate values from the cloud.env item in 1Password.

Most developers won't need these unless running or testing evals locally.

Publishing

Requires:

• 2FA on the myadbox-devs npm account (passkey stored in shared 1Password)
• NPM_TOKEN env var set to a granular access token with write access to @myadbox scope (there's a premade one in 1Password which expires 17 March 2026)

From the client/ directory:

nx run field-ai:build
nx release version patch --projects=field-ai  # or minor/major
npm publish dist/packages/util/field-ai

Note: We use npm publish directly instead of nx release publish because Yarn Berry doesn't support WebAuthn/passkey 2FA.