{"_id":"@agent-qa/core","name":"@agent-qa/core","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@agent-qa/core","version":"0.1.0","private":false,"type":"module","description":"Framework-based AI agent testing with convention over configuration","license":"MIT","main":"./dist/src/index.js","types":"./dist/src/index.d.ts","bin":{"agentqa":"dist/bin/agent-qa.js"},"exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"},"./helpers":{"types":"./dist/src/helpers/index.d.ts","import":"./dist/src/helpers/index.js"},"./traces":{"types":"./dist/src/traces/index.d.ts","import":"./dist/src/traces/index.js"}},"dependencies":{"chalk":"^5.4.1","commander":"^12.1.0","dotenv":"^16.4.7","p-limit":"^7.2.0","proper-lockfile":"^4.1.2","tsx":"^4.19.0","yaml":"^2.7.0","zod":"^3.24.1","zod-to-json-schema":"^3.24.1","@agent-qa/cost-registry":"0.1.0"},"peerDependencies":{"drizzle-orm":">=0.30.0","postgres":">=3.0.0","@zilliz/milvus2-sdk-node":">=2.0.0"},"peerDependenciesMeta":{"drizzle-orm":{"optional":true},"postgres":{"optional":true},"@zilliz/milvus2-sdk-node":{"optional":true}},"devDependencies":{"@types/node":"^20.19.23","@types/proper-lockfile":"^4.1.4","@vitest/coverage-v8":"^4.0.16","typescript":"^5.7.3","vitest":"^4.0.15"},"scripts":{"build":"tsc","dev":"tsc --watch","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","type-check":"tsc --noEmit","lint":"eslint src/","check":"pnpm lint && pnpm type-check","clean":"rm -rf dist"},"_id":"@agent-qa/core@0.1.0","_integrity":"sha512-CjkXpdQSysKf0+94dWaXOS0M01WI8bxh9DkhRt66x8uCQ7abr7ltb8iFqX/6cPtDg8Id3Skq++eygyhV0n7mzQ==","_resolved":"/tmp/83a2f818a65d8a21621a9c0642005b6b/agent-qa-core-0.1.0.tgz","_from":"file:agent-qa-core-0.1.0.tgz","_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-CjkXpdQSysKf0+94dWaXOS0M01WI8bxh9DkhRt66x8uCQ7abr7ltb8iFqX/6cPtDg8Id3Skq++eygyhV0n7mzQ==","shasum":"e46239c2f35c5a3fe1dd56233fca1ce4bc48da9c","tarball":"https://registry.npmjs.org/@agent-qa/core/-/core-0.1.0.tgz","fileCount":363,"unpackedSize":1211748,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGdQDGZgRwIaJmvK8+7Brcjh7bQx4V6pP05xKb7b9D0uAiEAh2lfmRhHcLhJTZRNt9LllTz0Nordl+e8VdAitl3SlF0="}]},"_npmUser":{"name":"tedjames24","email":"ted@agentdesk.ai"},"directories":{},"maintainers":[{"name":"tedjames24","email":"ted@agentdesk.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/core_0.1.0_1770054540522_0.35505418537808286"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-02T17:49:00.406Z","0.1.0":"2026-02-02T17:49:00.677Z","modified":"2026-02-02T17:49:00.959Z"},"maintainers":[{"name":"tedjames24","email":"ted@agentdesk.ai"}],"description":"Framework-based AI agent testing with convention over configuration","license":"MIT","readme":"# @agent-qa/core\n\nMain package for the Agent QA testing framework.\n\n## Installation\n\n```bash\nnpm install @agent-qa/core\n# or\npnpm add @agent-qa/core\n```\n\n## Features\n\n- **CLI**: Run tests, chat with agents, inspect databases\n- **YAML Scenarios**: Define tests in readable YAML format\n- **Assertions**: Tool calls, entity state, responses, usage\n- **Adapters**: Drizzle ORM, custom adapters, vector stores\n- **Lifecycle**: Global setup, per-scenario hooks\n- **Diagnostics**: Tmux logs, Tempo traces, failure debugging\n\n## Quick Start\n\n```typescript\n// agentqa.config.ts\nimport { defineConfig } from '@agent-qa/core';\n\nexport default defineConfig({\n  name: 'MyApp',\n  agent: {\n    baseUrl: '$API_URL',\n    token: '$API_TOKEN',\n  },\n});\n```\n\n```yaml\n# scenarios/suite.yaml\nname: My Tests\nscenarios:\n  - id: test-001\n    steps:\n      - chat: \"Hello\"\n        response:\n          contains: [\"hi\", \"hello\"]\n```\n\n```bash\nnpx agentqa run scenarios/suite.yaml\n```\n\n## CLI Commands\n\n| Command | Description |\n|---------|-------------|\n| `agentqa run <suite>` | Run test scenarios |\n| `agentqa chat` | Chat with agent interactively |\n| `agentqa db <entity>` | Inspect database entities |\n| `agentqa setup` | Start infrastructure |\n| `agentqa teardown` | Stop infrastructure |\n| `agentqa tokens` | Count tokens in text |\n| `agentqa schema-tokens` | Analyze Zod schema tokens |\n| `agentqa analyze-tokens` | Analyze diagnostics tokens |\n\n## Exports\n\n### Main\n\n```typescript\nimport {\n  // Config\n  defineConfig,\n  loadConfig,\n\n  // Runner\n  createTestRunner,\n  TestRunner,\n\n  // Adapters\n  createHttpAgent,\n  createDrizzleAdapter,\n  createMilvusAdapter,\n\n  // Lifecycle\n  runGlobalSetup,\n  runTeardown,\n} from '@agent-qa/core';\n```\n\n### Helpers\n\n```typescript\nimport {\n  dockerPostgres,\n  tmuxProcess,\n  dockerCompose,\n  frpTunnel,\n  waitForPort,\n  waitForHealth,\n} from '@agent-qa/core/helpers';\n```\n\n## Documentation\n\n- [Getting Started](../../docs/getting-started.md)\n- [Configuration](../../docs/configuration.md)\n- [YAML Scenarios](../../docs/yaml-scenarios.md)\n- [CLI Reference](../../docs/cli.md)\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-93ba6ec80dbf0999bc8b6a71d85e19be"}