{"_id":"@authoritas-ace/ace-cli","_rev":"4-bd9ec61679396eb00436a1659e34330e","name":"@authoritas-ace/ace-cli","dist-tags":{"latest":"2.0.0"},"versions":{"1.0.0":{"name":"@authoritas-ace/ace-cli","version":"1.0.0","keywords":["ace","cli","commerce","feed","enrichment","content"],"license":"MIT","_id":"@authoritas-ace/ace-cli@1.0.0","maintainers":[{"name":"authoritas-ace","email":"marketing@authoritas.com"}],"bin":{"ace":"dist/index.js"},"dist":{"shasum":"adb8b8408881d69e632caad90be506179bd09433","tarball":"https://registry.npmjs.org/@authoritas-ace/ace-cli/-/ace-cli-1.0.0.tgz","fileCount":23,"integrity":"sha512-OIhaWmNFJpwpYqEz2AW8P2haHEOrj8kboRyePaXIJCyXoy3QQA8mErUi9j0Nf4zMg96H7+B4dCs192NrgkZJBQ==","signatures":[{"sig":"MEQCIDGOpSil+2U52nW+vwfGwVUXmqcoTkIJNH8aE9g8YUjPAiBZsVQx9wYvCWmqULQsXUBIJmle5j7Z/PQfkyO9ZLzEpA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15877},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"722892094840cb9abbd37754ae04b7110ae6fe87","scripts":{"build":"tsc","prepare":"npm run build"},"_npmUser":{"name":"authoritas-ace","email":"marketing@authoritas.com"},"_npmVersion":"10.9.3","description":"CLI for ACE (Agentic Commerce Engine) APIs: feeds, content, enrichment, credits","directories":{},"_nodeVersion":"22.20.0","dependencies":{"commander":"^12.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5","@types/node":"^20"},"_npmOperationalInternal":{"tmp":"tmp/ace-cli_1.0.0_1772208755986_0.7204407969213618","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@authoritas-ace/ace-cli","version":"1.0.1","keywords":["ace","cli","commerce","feed","enrichment","content"],"license":"MIT","_id":"@authoritas-ace/ace-cli@1.0.1","maintainers":[{"name":"authoritas-ace","email":"marketing@authoritas.com"}],"bin":{"ace":"dist/index.js"},"dist":{"shasum":"ddeadacc41505022216027afe6d041ef65625495","tarball":"https://registry.npmjs.org/@authoritas-ace/ace-cli/-/ace-cli-1.0.1.tgz","fileCount":23,"integrity":"sha512-cuprruDyfjbvjcidwBSXCjxvo5rnl/r0h2x9G+Vgyxfmg5jW8Wl827navqgzKsQzFjDTzROakI7WVjMqnu4+LA==","signatures":[{"sig":"MEYCIQCogbqiqqA7pjqvOoGXYfGeaBmeI4ImJ4vF1TYpWQUG7wIhALJP60WrtGC1MR3bt7s60bz11eoJCSkwEQ6jjAzKizRF","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15707},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"7ed7c68608db74af71ede90ee73bef7f39d52a18","scripts":{"build":"tsc","prepare":"npm run build"},"_npmUser":{"name":"authoritas-ace","email":"marketing@authoritas.com"},"_npmVersion":"10.9.3","description":"CLI for ACE (Agentic Commerce Engine) APIs: feeds, content, enrichment, credits","directories":{},"_nodeVersion":"22.20.0","dependencies":{"commander":"^12.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5","@types/node":"^20"},"_npmOperationalInternal":{"tmp":"tmp/ace-cli_1.0.1_1772461334455_0.6110001026921739","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@authoritas-ace/ace-cli","version":"1.0.2","keywords":["ace","cli","commerce","feed","enrichment","content"],"license":"MIT","_id":"@authoritas-ace/ace-cli@1.0.2","maintainers":[{"name":"authoritas-ace","email":"marketing@authoritas.com"}],"bin":{"ace":"dist/index.js"},"dist":{"shasum":"0c9aec1b8d5e4ce9002b2f6be7ba3e3c60e7bce7","tarball":"https://registry.npmjs.org/@authoritas-ace/ace-cli/-/ace-cli-1.0.2.tgz","fileCount":23,"integrity":"sha512-W8eP4Od2rqCggDe0TJJ6WP/Q1j22+FWUJ/FO5WKMMiJksmjVqPd9O2ixyYVVhx3cpNrhXrVLqU2JPPps1zK8nw==","signatures":[{"sig":"MEYCIQDvZ6ugNUeBsKbT4tzC9SlqSA9cvYikUf14vQiJrN7gcwIhAMxt+PKrr+c+WSLQ98hHPqzN1jgOoEh+p+VIisW7FCxe","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19846},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"7ed7c68608db74af71ede90ee73bef7f39d52a18","scripts":{"build":"tsc","prepare":"npm run build"},"_npmUser":{"name":"authoritas-ace","email":"marketing@authoritas.com"},"_npmVersion":"10.9.3","description":"CLI for ACE (Agentic Commerce Engine) APIs: feeds, content, enrichment, credits","directories":{},"_nodeVersion":"22.20.0","dependencies":{"commander":"^12.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5","@types/node":"^20"},"_npmOperationalInternal":{"tmp":"tmp/ace-cli_1.0.2_1772461559375_0.12449677111913227","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@authoritas-ace/ace-cli","version":"2.0.0","description":"CLI for the ACE (Agentic Commerce Engine) v1 API: contextual enrichment, durable jobs, projects, experiments, webhooks","type":"module","main":"dist/index.js","bin":{"ace":"dist/index.js"},"scripts":{"build":"tsc"},"keywords":["ace","cli","commerce","feed","enrichment","content"],"license":"MIT","engines":{"node":">=18"},"dependencies":{"@authoritas-ace/ace-sdk":"^2.0.0","commander":"^12.0.0"},"devDependencies":{"@types/node":"^20","typescript":"^5"},"publishConfig":{"access":"public"},"_id":"@authoritas-ace/ace-cli@2.0.0","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-n9YnjmnB50s3sr9CXFdcZVZqR3DWYyhcdDX0Y4t7zGmjU/wsh0d+UZxeNpsBCSfl+e33XbXmZsGy2ZCkavSw9Q==","shasum":"493c77367c4b933eb20ba7acb512936c65122607","tarball":"https://registry.npmjs.org/@authoritas-ace/ace-cli/-/ace-cli-2.0.0.tgz","fileCount":32,"unpackedSize":32496,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICucd3f+rRNhHFG01EmDAOfdJJYE8VHClSo+WTa9PhSeAiEAjYO/O5d1r9DiRHd/lLoIwir9aL0160yW0rTcstUH8Ec="}]},"_npmUser":{"name":"authoritas-ace","email":"marketing@authoritas.com"},"directories":{},"maintainers":[{"name":"authoritas-ace","email":"marketing@authoritas.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ace-cli_2.0.0_1785483765366_0.8506984809047764"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-27T16:12:35.924Z","modified":"2026-07-31T07:42:45.647Z","1.0.0":"2026-02-27T16:12:36.133Z","1.0.1":"2026-03-02T14:22:14.586Z","1.0.2":"2026-03-02T14:25:59.517Z","2.0.0":"2026-07-31T07:42:45.505Z"},"license":"MIT","keywords":["ace","cli","commerce","feed","enrichment","content"],"description":"CLI for the ACE (Agentic Commerce Engine) v1 API: contextual enrichment, durable jobs, projects, experiments, webhooks","maintainers":[{"name":"authoritas-ace","email":"marketing@authoritas.com"}],"readme":"# ace-cli\n\n**ace-cli** is the command-line interface for ACE (Agentic Commerce Engine). Use it to run the Contextual Enrichment Engine, track durable jobs, score a feed, and manage projects, experiments and webhooks without writing any code.\n\nIt is a thin wrapper over the [ACE SDK](https://www.npmjs.com/package/@authoritas-ace/ace-sdk), so every command maps to one documented endpoint. The long-form guide lives at [ace.authoritas.com/docs/cli](https://ace.authoritas.com/docs/cli).\n\n## Install\n\n```bash\nnpm install -g @authoritas-ace/ace-cli\n```\n\nOr run it without installing:\n\n```bash\nnpx @authoritas-ace/ace-cli health\n```\n\nNode 18 or newer.\n\n## Configure\n\nSet your base URL and key once, and every command picks them up:\n\n```bash\nexport ACE_BASE_URL=https://ace.authoritas.com\nexport ACE_API_KEY=ace_live_your_key_here\n```\n\nBoth can also be passed per command with `--base-url` and `--api-key`. If `ACE_BASE_URL` is unset the CLI falls back to `http://localhost:3001`, which is only useful when running ACE locally, so set it explicitly against production.\n\nCreate a key under **Settings, Developer console, Keys**. Everything except `ace health` needs one.\n\n## Check the connection\n\n```bash\nace health\nace usage\n```\n\n`usage` shows your credit balance, rate limit, job count, and (for `ace_test_` keys) the free monthly quota.\n\n## Contextual Enrichment Engine\n\nEvery enrichment command reads its JSON body from stdin, or from a file with `--file`.\n\n```bash\n# Generate contextual rules for a product set\nace rules --file products.json\n\n# Generate content grounded in those rules\nace enrich-content --file content-request.json\n\n# Run both steps in one call\necho '{\"source\":{\"type\":\"inline\",\"products\":[{\"id\":\"1\",\"title\":\"Merino base layer\"}]},\n       \"contentTypes\":[\"product-description\"]}' | ace pipeline\n```\n\nA product needs only `id` and `title`. Any extra keys become grounding signal.\n\n## Jobs\n\nLarge requests run asynchronously and return a job. Track it:\n\n```bash\nace jobs list --status running\nace jobs get <id>\nace jobs wait <id> --timeout-ms 300000\nace jobs results <id> --page 1 --page-size 50\nace jobs cancel <id>\n```\n\n## Projects\n\n```bash\nace projects list\nace projects get <id>\nace projects create --name \"Autumn catalogue\"\nace projects update <id> --name \"Autumn catalogue 2026\"\nace projects delete <id>\n```\n\n## Experiments\n\nEvery experiments command is project-scoped, so `--project-id` is required.\n\n```bash\nace experiments list --project-id <projectId>\nace experiments get <id> --project-id <projectId>\nace experiments create --project-id <projectId> --file experiment.json\nace experiments update <id> --project-id <projectId> --file changes.json\nace experiments delete <id> --project-id <projectId>\n```\n\n## Webhooks\n\n```bash\nace webhooks create \\\n  --url https://example.com/hooks/ace \\\n  --events enrichment.job.succeeded,enrichment.job.failed\n\nace webhooks list\nace webhooks get <id>\nace webhooks update <id> --file changes.json\nace webhooks delete <id>\nace webhooks deliveries <id> --status failed --page-size 50\n```\n\nThe URL must be https. Each subscription carries a signing secret: verify the signature header on your endpoint against it before trusting a payload.\n\n## Utilities and feeds\n\nNone of these consume credits.\n\n```bash\nace utils language --file products.json\nace utils agentic-readiness --file products.json\nace utils review-quality --file items.json\n\nace feeds --project-id <projectId>\n```\n\n## Output\n\nCommands print the response payload as formatted JSON on stdout, so they pipe into `jq` cleanly. On an API error the message goes to stderr and the process exits non-zero, which makes the CLI safe to use in a build step.\n\n```bash\nace jobs list --status failed | jq '.[].id'\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}