jaz-clio 4.18.0 → 4.18.1

package/assets/skills/api/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-api
-version: 4.18.0
+version: 4.18.1
 description: Complete reference for the Jaz REST API — the accounting platform backend. Use this skill whenever building, modifying, debugging, or extending any code that calls the API — including API clients, integrations, data seeding, test data, or new endpoint work. Contains every field name, response shape, error, gotcha, and edge case discovered through live production testing.
 license: MIT
 compatibility: Requires Jaz API key (x-jk-api-key header). Works with Claude Code, Google Antigravity, OpenAI Codex, GitHub Copilot, Cursor, and any agent that reads markdown.
@@ -121,7 +121,7 @@ You are working with the **Jaz REST API** — the accounting platform backend. A
 49. **Currency rate direction: `rate` = functionalToSource (1 base = X foreign)** — POST `rate: 0.74` for a SGD org means 1 SGD = 0.74 USD. **If your data stores rates as "1 USD = 1.35 SGD" (sourceToFunctional), you MUST invert: `rate = 1 / 1.35 = 0.74`.** GET confirms both: `rateFunctionalToSource` (what you POSTed) and `rateSourceToFunctional` (the inverse).
 
 ### Search & Filter
-50. **Search endpoint universal pattern** — All 28 `POST /*/search` endpoints share identical structure: `{ filter?, sort: { sortBy: ["field"], order: "ASC"|"DESC" }, limit: 1-1000, offset: 0-65536 }`. Sort is REQUIRED when offset is present (even `offset: 0`). Default limit: 100. `sortBy` is always an array on all endpoints (no exceptions). See `references/search-reference.md` for per-endpoint filter/sort fields.
+50. **Search endpoint universal pattern** — All 28 `POST /*/search` endpoints share identical structure: `{ filter?, sort: { sortBy: ["field"], order: "ASC"|"DESC" }, limit: 1-1000, offset: 0-65536 }`. **`offset` is a page number (0-indexed), NOT row-skip.** `offset=0` = first page, `offset=1` = second page. Sort is REQUIRED when offset is present (even `offset: 0`). Default limit: 100. `sortBy` is always an array on all endpoints (no exceptions). See `references/search-reference.md` for per-endpoint filter/sort fields.
 51. **Filter operator reference** — String: `eq`, `neq`, `contains`, `in` (array, max 100), `likeIn` (array, max 100), `reg` (regex array, max 100), `isNull` (bool). Numeric: `eq`, `gt`, `gte`, `lt`, `lte`, `in`. Date (YYYY-MM-DD): `eq`, `gt`, `gte`, `lt`, `lte`, `between` (exactly 2 values). DateTime (RFC3339): same operators, converted to epoch ms internally. Boolean: `eq`. JSON: `jsonIn`, `jsonNotIn`. Logical: nest with `and`/`or`/`not` objects, or use `andGroup`/`orGroup` arrays (invoices, bills, journals, credit notes).
 52. **Date format asymmetry (CRITICAL)** — Request dates: `YYYY-MM-DD` strings (all create/update and DateExpression filters). Request datetimes: RFC3339 strings (DateTimeExpression filters for `createdAt`, `updatedAt`, `approvedAt`, `submittedAt`). **ALL response dates**: `int64` epoch milliseconds — including `valueDate`, `createdAt`, `updatedAt`, `approvedAt`, `submittedAt`, `matchDate`. Convert: `new Date(epochMs).toISOString().slice(0,10)`. **Timezone convention**: ALL business dates (`valueDate`, `dueDate`, `startDate`, `endDate`, etc.) are in the **organization's timezone** — never UTC. The epoch ms stored in the DB represents the org-local date (no timezone conversion is ever needed). Only audit timestamps (`createdAt`, `updatedAt`, `action_at`) are UTC.
 53. **Field aliases on create endpoints** — Middleware transparently maps: `issueDate`/`date` → `valueDate` (invoices, bills, credit notes, journals). `name` → `tagName` (tags) or `internalName` (items). `paymentDate` → `valueDate`, `bankAccountResourceId` → `accountResourceId` (payments). `paymentAmount` → `refundAmount`, `paymentMethod` → `refundMethod` (credit note refunds). `accountType` → `classificationType`, `currencyCode` → `currency` (CoA). Canonical names always work; aliases are convenience only.

package/assets/skills/api/references/endpoints.md

@@ -32,12 +32,14 @@ Content-Type: application/json
 
 All GET list endpoints and POST `/search` endpoints use **`limit`/`offset` pagination** — NOT `page`/`size`.
 
+**IMPORTANT: `offset` is a page number (0-indexed), NOT a row-skip count.** `offset=0` returns the first page, `offset=1` returns the second page, etc. Example: `offset=2, limit=50` returns items 100–149.
+
 | Property | Value |
 |----------|-------|
 | **GET list endpoints** | `?limit=100&offset=0` (query params) |
 | **POST /search endpoints** | `{ "limit": 100, "offset": 0 }` (JSON body) |
 | **Default limit** | 100 (if omitted) |
-| **Default offset** | 0 (if omitted) |
+| **Default offset** | 0 (first page) |
 | **Max limit** | 1000 |
 | **Min limit** | 1 |
 | **Max offset** | 65536 |
@@ -1452,7 +1454,7 @@ POST /api/v1/invoices/search
 
 ### Pagination
 - `limit`: max 1000 per page (default 100)
-- `offset`: skip N results (max 65536)
+- `offset`: page number, 0-indexed (max 65536)
 - `sort`: **REQUIRED when `offset` is present** (even `offset: 0`)
 - Response includes `totalElements` and `totalPages`
 

package/assets/skills/api/references/errors.md

@@ -713,7 +713,7 @@ Journals support a top-level `currency` object to create entries in a foreign cu
 
 ### "limit must be 1000 or less" (422)
 **Cause**: Sending `?limit=1001` or higher on a GET endpoint.
-**Fix**: Maximum limit is 1000. To fetch all records, paginate with `limit=1000&offset=0`, then `limit=1000&offset=1000`, etc.
+**Fix**: Maximum limit is 1000. To fetch all records, paginate with `limit=1000&offset=0`, then `limit=1000&offset=1` (offset is a page number, not row-skip), etc.
 
 ### "offset must be 65536 or less" (422)
 **Cause**: Offset exceeds maximum.

package/assets/skills/api/references/field-map.md

@@ -469,9 +469,9 @@ DELETE → expects "A" (parentEntityResourceId, via /cashflow-journals/:id)
 | `size` | NOT SUPPORTED | Silently ignored — use `limit`/`offset` |
 | `pageSize` | NOT SUPPORTED | Use `limit` |
 | `per_page` | NOT SUPPORTED | Use `limit` |
-| `page_number` | NOT SUPPORTED | Use `offset` (item-based, not page-based) |
+| `page_number` | `offset` | **offset IS the page number (0-indexed)**, not a row-skip count. `offset=0` = page 1, `offset=1` = page 2. |
 | (default page size) | `limit` (default: 100) | Query param for GET, JSON body for POST /search |
-| (skip N items) | `offset` (default: 0) | Query param for GET, JSON body for POST /search |
+| (page number) | `offset` (default: 0) | 0-indexed page number. `offset=2, limit=50` returns items 100–149. |
 
 **GET list endpoints**: `?limit=100&offset=0` (query params)
 **POST /search endpoints**: `{ "limit": 100, "offset": 0 }` (JSON body)

package/assets/skills/api/references/full-api-surface.md

@@ -589,10 +589,12 @@ All 28 `POST /*/search` endpoints accept this filter structure in the POST body:
 
 All list/search endpoints use `limit`/`offset` — NOT `page`/`size`. This applies to both GET (query params) and POST /search (JSON body).
 
+**IMPORTANT: `offset` is a page number (0-indexed), NOT a row-skip count.** `offset=0` = first page, `offset=1` = second page. Example: `offset=2, limit=50` returns items 100–149.
+
 | Property | Value |
 |----------|-------|
 | Default limit | 100 |
-| Default offset | 0 |
+| Default offset | 0 (first page) |
 | Min limit | 1 |
 | Max limit | 1000 |
 | Max offset | 65536 |

package/assets/skills/api/references/search-reference.md

@@ -24,7 +24,7 @@ All search endpoints share this identical structure:
 | `filter` | object | No | Per-endpoint fields (see tables below) |
 | `sort` | object | **Yes if `offset` is present** | `sortBy`: array of field names; `order`: `"ASC"` or `"DESC"` |
 | `limit` | int | No | Default: 100, min: 1, max: 1000 |
-| `offset` | int | No | Default: 0, min: 0, max: 65536 |
+| `offset` | int | No | **Page number** (0-indexed, not row-skip). Default: 0, min: 0, max: 65536 |
 
 **Response shape**: `{ totalElements, totalPages, data: [...] }` — all search/list endpoints return this flat structure directly (no outer `data` wrapper).
 

package/assets/skills/conversion/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-conversion
-version: 4.18.0
+version: 4.18.1
 description: Accounting data conversion skill — migrates customer data from Xero, QuickBooks, Sage, MYOB, and Excel exports to Jaz. Covers config, quick, and full conversion workflows, Excel parsing, CoA/contact/tax/items mapping, clearing accounts, TTB, and TB verification.
 ---
 

package/assets/skills/jobs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-jobs
-version: 4.18.0
+version: 4.18.1
 description: 12 accounting jobs for SMB bookkeepers and accountants — month-end, quarter-end, and year-end close playbooks plus 9 ad-hoc operational jobs (bank recon, document collection, GST/VAT filing, payment runs, credit control, supplier recon, audit prep, fixed asset review, statutory filing). Jobs can have paired tools as nested subcommands (e.g., `clio jobs bank-recon match`, `clio jobs document-collection ingest`, `clio jobs statutory-filing sg-cs`). Paired with an interactive CLI blueprint generator (clio jobs).
 license: MIT
 compatibility: Works with Claude Code, Claude Cowork, Claude.ai, and any agent that reads markdown. For API payloads, load the jaz-api skill. For individual transaction patterns, load the jaz-recipes skill.

package/assets/skills/jobs/references/sg-tax/data-extraction.md

@@ -294,7 +294,8 @@ All search endpoints support pagination. The standard pattern:
 ```
 
 **Check the response metadata:**
-- If `totalCount` exceeds your `limit`, make additional requests incrementing `offset` by `limit`
+- `offset` is a **page number** (0-indexed), NOT a row-skip count. Increment `offset` by 1 for each subsequent page.
+- Example: `offset=0` returns items 0–999, `offset=1` returns items 1000–1999, etc.
 - Always aggregate totals across all pages before mapping to input fields
 - Do not assume a single page contains all results
 

package/assets/skills/transaction-recipes/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-recipes
-version: 4.18.0
+version: 4.18.1
 description: 16 IFRS-compliant recipes for complex multi-step accounting in Jaz — prepaid amortization, deferred revenue, loan schedules, IFRS 16 leases, hire purchase, fixed deposits, asset disposal, FX revaluation, ECL provisioning, IAS 37 provisions, dividends, intercompany, and capital WIP. Each recipe includes journal entries, capsule structure, and verification steps. Paired with 13 financial calculators that produce execution-ready blueprints with workings.
 license: MIT
 compatibility: Works with Claude Code, Claude Cowork, Claude.ai, and any agent that reads markdown. For API payloads, load the jaz-api skill alongside this one.

package/dist/commands/accounts.js

@@ -12,7 +12,7 @@ export function registerAccountsCommand(program) {
         .command('list')
         .description('List accounts')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -39,7 +39,7 @@ export function registerAccountsCommand(program) {
         .option('--sort <field>', 'Sort field (default: code)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: ASC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/bills.js

@@ -16,7 +16,7 @@ export function registerBillsCommand(program) {
         .command('list')
         .description('List bills')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -84,7 +84,7 @@ export function registerBillsCommand(program) {
         .option('--sort <field>', 'Sort field (default: valueDate)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: DESC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/bookmarks.js

@@ -12,7 +12,7 @@ export function registerBookmarksCommand(program) {
         .command('list')
         .description('List bookmarks')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/capsules.js

@@ -12,7 +12,7 @@ export function registerCapsulesCommand(program) {
         .command('list')
         .description('List capsules')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -39,7 +39,7 @@ export function registerCapsulesCommand(program) {
         .option('--sort <field>', 'Sort field (default: title)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: ASC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/cash-entry.js

@@ -40,7 +40,7 @@ export function registerCashEntryCommand(program, config) {
         .command('list')
         .description(`List ${config.label.toLowerCase()} entries`)
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -191,7 +191,7 @@ export function registerCashEntryCommand(program, config) {
         .option('--sort <field>', 'Sort field (default: valueDate)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: DESC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/cash-transfer.js

@@ -15,7 +15,7 @@ export function registerCashTransferCommand(program) {
         .command('list')
         .description('List cash transfers')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -129,7 +129,7 @@ export function registerCashTransferCommand(program) {
         .option('--sort <field>', 'Sort field (default: valueDate)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: DESC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/cashflow.js

@@ -22,7 +22,7 @@ export function registerCashflowCommand(program) {
         .option('--sort <field>', 'Sort field (default: valueDate)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: DESC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/contacts.js

@@ -12,7 +12,7 @@ export function registerContactsCommand(program) {
         .command('list')
         .description('List contacts')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -41,7 +41,7 @@ export function registerContactsCommand(program) {
         .command('search <query>')
         .description('Search contacts by name or billing name')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--customer', 'Filter to customers only')

package/dist/commands/currency-rates.js

@@ -12,7 +12,7 @@ export function registerCurrencyRatesCommand(program) {
         .command('list <currencyCode>')
         .description('List exchange rates for a currency')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/customer-credit-notes.js

@@ -16,7 +16,7 @@ export function registerCustomerCreditNotesCommand(program) {
         .command('list')
         .description('List customer credit notes')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -79,7 +79,7 @@ export function registerCustomerCreditNotesCommand(program) {
         .option('--sort <field>', 'Sort field (default: valueDate)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: DESC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/invoices.js

@@ -16,7 +16,7 @@ export function registerInvoicesCommand(program) {
         .command('list')
         .description('List invoices')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -86,7 +86,7 @@ export function registerInvoicesCommand(program) {
         .option('--sort <field>', 'Sort field (default: valueDate)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: DESC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/items.js

@@ -12,7 +12,7 @@ export function registerItemsCommand(program) {
         .command('list')
         .description('List items')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -47,7 +47,7 @@ export function registerItemsCommand(program) {
         .option('--sort <field>', 'Sort field (default: internalName)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: ASC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/journals.js

@@ -16,7 +16,7 @@ export function registerJournalsCommand(program) {
         .command('list')
         .description('List journals')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -49,7 +49,7 @@ export function registerJournalsCommand(program) {
         .option('--sort <field>', 'Sort field (default: valueDate)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: DESC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/org-users.js

@@ -12,7 +12,7 @@ export function registerOrgUsersCommand(program) {
         .command('list')
         .description('List organization users')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -40,7 +40,7 @@ export function registerOrgUsersCommand(program) {
         .option('--sort <field>', 'Sort field (default: firstName)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: ASC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/payments.js

@@ -15,7 +15,7 @@ export function registerPaymentsCommand(program) {
         .command('list')
         .description('List recent cashflow transactions')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -49,7 +49,7 @@ export function registerPaymentsCommand(program) {
         .option('--sort <field>', 'Sort field (default: valueDate)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: DESC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/schedulers.js

@@ -15,7 +15,7 @@ export function registerSchedulersCommand(program) {
         .command('list-invoices')
         .description('List scheduled invoices')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -40,7 +40,7 @@ export function registerSchedulersCommand(program) {
         .command('list-bills')
         .description('List scheduled bills')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -65,7 +65,7 @@ export function registerSchedulersCommand(program) {
         .command('list-journals')
         .description('List scheduled journals')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/supplier-credit-notes.js

@@ -16,7 +16,7 @@ export function registerSupplierCreditNotesCommand(program) {
         .command('list')
         .description('List supplier credit notes')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -79,7 +79,7 @@ export function registerSupplierCreditNotesCommand(program) {
         .option('--sort <field>', 'Sort field (default: valueDate)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: DESC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/tags.js

@@ -12,7 +12,7 @@ export function registerTagsCommand(program) {
         .command('list')
         .description('List tags')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -56,7 +56,7 @@ export function registerTagsCommand(program) {
         .option('--sort <field>', 'Sort field (default: tagName)')
         .option('--order <direction>', 'Sort order: ASC or DESC (default: ASC)')
         .option('--limit <n>', 'Max results (default 20)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/commands/tax-profiles.js

@@ -12,7 +12,7 @@ export function registerTaxProfilesCommand(program) {
         .command('list')
         .description('List tax profiles')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
@@ -37,7 +37,7 @@ export function registerTaxProfilesCommand(program) {
         .command('types')
         .description('List available tax types (GST, VAT, WHT, etc.)')
         .option('--limit <n>', 'Max results (default 100)', parsePositiveInt)
-        .option('--offset <n>', 'Offset for pagination', parseNonNegativeInt)
+        .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')

package/dist/core/api/client.js

@@ -170,13 +170,15 @@ export class JazClient {
      */
     async listAll(path, pageSize = 200) {
         const all = [];
-        let offset = 0;
+        let page = 0;
         let hasMore = true;
         while (hasMore) {
-            const page = await this.list(path, { limit: pageSize, offset });
-            all.push(...page.data);
-            offset += pageSize;
-            hasMore = offset < page.totalElements;
+            const result = await this.list(path, { limit: pageSize, offset: page });
+            all.push(...result.data);
+            if (result.data.length < pageSize)
+                break;
+            page += 1;
+            hasMore = page * pageSize < result.totalElements;
         }
         return all;
     }

package/dist/core/api/pagination.js

@@ -10,12 +10,15 @@ const DEFAULT_PAGE_SIZE = 200;
  * Works with any endpoint returning PaginatedResponse<T> — the caller
  * wraps their specific API call into a (offset, limit) => Promise lambda.
  *
+ * NOTE: offset = page number (0-indexed), NOT row-skip count.
+ * offset=0 is page 1, offset=1 is page 2, etc.
+ *
  * Strategy:
  *   1. First call at offset=0 → get totalElements
  *   2. Short-circuit if single page (total <= pageSize)
- *   3. Compute remaining offsets, cap at MAX_OFFSET (65,536)
+ *   3. Compute remaining page numbers, cap at MAX_OFFSET (65,536)
  *   4. Fire batches of `concurrency` concurrent requests via Promise.all
- *   5. Merge results in offset order (Promise.all preserves order)
+ *   5. Merge results in page order (Promise.all preserves order)
  */
 export async function fetchAllPages(fetcher, options = {}) {
     const pageSize = Math.min(Math.max(options.pageSize ?? DEFAULT_PAGE_SIZE, 1), 1000);
@@ -36,15 +39,15 @@ export async function fetchAllPages(fetcher, options = {}) {
             requestCount,
         };
     }
-    // ── Step 2: Compute remaining offsets ──
-    // MAX_OFFSET is inclusive — API accepts offset=65536, rejects 65537+
+    // ── Step 2: Compute remaining page numbers ──
+    // offset = page number (0-indexed). MAX_OFFSET is inclusive (API accepts 0–65536).
+    const totalPages = Math.ceil(total / pageSize);
     const offsets = [];
-    for (let offset = pageSize; offset < total && offset <= MAX_OFFSET; offset += pageSize) {
-        offsets.push(offset);
+    for (let page = 1; page < totalPages && page <= MAX_OFFSET; page++) {
+        offsets.push(page);
     }
-    // Truncated if there are items beyond what we can fetch
-    const maxFetchable = (offsets.length + 1) * pageSize;
-    const truncated = total > maxFetchable;
+    // Truncated if there are pages beyond what the offset cap allows
+    const truncated = totalPages > MAX_OFFSET + 1;
     // ── Step 3: Concurrent batched fetching ──
     const allData = [...firstPage.data];
     onProgress?.(allData.length, total);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaz-clio",
-  "version": "4.18.0",
+  "version": "4.18.1",
   "description": "Clio — Command Line Interface Orchestrator for Jaz AI.",
   "type": "module",
   "bin": {