@eide/foir-cli 0.30.1 → 0.31.0

package/dist/cli.js

@@ -704,8 +704,8 @@ function createIdentityMethods(client) {
           search: params.search,
           status: params.status,
           role: params.role,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -768,8 +768,8 @@ function createIdentityMethods(client) {
         create(ListCustomersRequestSchema, {
           search: params.search,
           status: params.status,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -812,8 +812,8 @@ function createIdentityMethods(client) {
       const resp = await client.listTenants(
         create(ListTenantsRequestSchema, {
           status: params.status,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -868,8 +868,8 @@ function createIdentityMethods(client) {
         create(ListProjectsRequestSchema, {
           tenantId: params.tenantId,
           status: params.status,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -918,8 +918,8 @@ function createIdentityMethods(client) {
         create(ListInvitationsRequestSchema, {
           tenantId: params.tenantId,
           status: params.status,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -976,8 +976,8 @@ function createIdentityMethods(client) {
     async listApiKeys(params = {}) {
       const resp = await client.listApiKeys(
         create(ListApiKeysRequestSchema, {
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -1026,8 +1026,8 @@ function createIdentityMethods(client) {
       const resp = await client.listAuthProviders(
         create(ListAuthProvidersRequestSchema, {
           enabled: params.enabled,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -1377,8 +1377,8 @@ function createModelsMethods(client) {
           search: params.search,
           category: params.category,
           configId: params.configId,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -1433,8 +1433,8 @@ function createModelsMethods(client) {
       const resp = await client.listModelVersions(
         create3(ListModelVersionsRequestSchema, {
           modelId,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -1673,8 +1673,8 @@ function createRecordsMethods(client) {
       const resp = await client.listRecordVersions(
         create4(ListRecordVersionsRequestSchema, {
           parentId,
-          limit: params?.limit ?? 50,
-          offset: params?.offset ?? 0
+          first: params?.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -1718,8 +1718,8 @@ function createRecordsMethods(client) {
       const resp = await client.listRecordVariants(
         create4(ListRecordVariantsRequestSchema, {
           recordId,
-          limit: params?.limit ?? 50,
-          offset: params?.offset ?? 0
+          first: params?.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -1762,8 +1762,8 @@ function createRecordsMethods(client) {
             nanos: 0
           } : void 0,
           modelKey: params?.modelKey,
-          limit: params?.limit ?? 50,
-          offset: params?.offset ?? 0
+          first: params?.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -1776,8 +1776,8 @@ function createRecordsMethods(client) {
         create4(ListDraftVersionsRequestSchema, {
           modelKey: params?.modelKey,
           search: params?.search,
-          limit: params?.limit ?? 50,
-          offset: params?.offset ?? 0
+          first: params?.first ?? 50,
+          after: params?.after
         })
       );
       return {
@@ -1801,7 +1801,8 @@ function createRecordsMethods(client) {
         create4(GlobalSearchRequestSchema, {
           query: params.query,
           modelKeys: params.modelKeys ?? [],
-          limit: params.limit ?? 20
+          first: params.first ?? 20,
+          after: params?.after
         })
       );
       return {
@@ -1828,7 +1829,8 @@ function createRecordsMethods(client) {
         create4(FindSimilarRecordsRequestSchema, {
           recordId: params.recordId,
           modelKey: params.modelKey,
-          limit: params.limit ?? 10
+          first: params.first ?? 10,
+          after: params?.after
         })
       );
       return resp.records ?? [];
@@ -1856,7 +1858,8 @@ function createRecordsMethods(client) {
         create4(SearchEmbeddingsRequestSchema, {
           queryVector: params.queryVector,
           modelKey: params.modelKey,
-          limit: params.limit ?? 10
+          first: params.first ?? 10,
+          after: params?.after
         })
       );
       return resp.results ?? [];
@@ -1894,8 +1897,8 @@ function createConfigsMethods(client) {
           category: params.category,
           isActive: params.isActive,
           search: params.search,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -1917,8 +1920,8 @@ function createConfigsMethods(client) {
         create5(ListConfigsRequestSchema, {
           configType: params.configType,
           enabled: params.enabled,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2055,8 +2058,8 @@ function createSegmentsMethods(client) {
         create6(ListSegmentsRequestSchema, {
           isActive: params.isActive,
           configId: params.configId,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2224,8 +2227,8 @@ function createSettingsMethods(client) {
         create7(ListMyMentionsRequestSchema, {
           status: params.status ?? [],
           entityType: params.entityType,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2259,8 +2262,8 @@ function createSettingsMethods(client) {
         create7(ListNotesRequestSchema, {
           entityType: params.entityType,
           entityId: params.entityId,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2285,8 +2288,8 @@ function createSettingsMethods(client) {
       return client.listContextDimensions(
         create7(ListContextDimensionsRequestSchema, {
           search: params.search,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2319,8 +2322,8 @@ function createSettingsMethods(client) {
         create7(GetContextDimensionValuesRequestSchema, {
           dimensionKey,
           search: params.search,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2419,8 +2422,8 @@ function createSettingsMethods(client) {
       return client.listVariantCatalog(
         create7(ListVariantCatalogRequestSchema, {
           isActive: params.isActive,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2469,8 +2472,8 @@ function createSettingsMethods(client) {
       return client.listLocales(
         create7(ListLocalesRequestSchema, {
           includeInactive: params.includeInactive,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2549,10 +2552,10 @@ function createSettingsMethods(client) {
       return resp.preferences ?? null;
     },
     // ── Recently Opened ─────────────────────────────────────
-    async listRecentlyOpened(limit) {
+    async listRecentlyOpened(first) {
       const resp = await client.listRecentlyOpened(
         create7(ListRecentlyOpenedRequestSchema, {
-          limit: limit ?? 20
+          first: first ?? 20
         })
       );
       return resp.items ?? [];
@@ -2632,8 +2635,8 @@ function createStorageMethods(client) {
           mimeType: params.mimeType,
           search: params.search,
           includeDeleted: params.includeDeleted ?? false,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2695,6 +2698,8 @@ function createStorageMethods(client) {
       );
       return resp.success;
     },
+    // Documented Stage-9 exception: CleanupOrphanedFiles is a write-batch
+    // ceiling, not list pagination, so it keeps `limit` rather than `first`.
     async cleanupOrphanedFiles(params) {
       return client.cleanupOrphanedFiles(
         create8(CleanupOrphanedFilesRequestSchema, {
@@ -2732,8 +2737,8 @@ function createOperationsMethods(client) {
           category: params.category,
           isActive: params.isActive,
           search: params.search,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2821,8 +2826,8 @@ function createOperationsMethods(client) {
       return client.listDeadLetterEntries(
         create9(ListDeadLetterEntriesRequestSchema, {
           operationKey: params.operationKey,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2869,8 +2874,8 @@ function createHooksMethods(client) {
           event: params.event,
           isActive: params.isActive,
           configId: params.configId,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2928,8 +2933,8 @@ function createHooksMethods(client) {
         create10(ListHookDeliveriesRequestSchema, {
           hookId: params.hookId,
           status: params.status,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -2968,8 +2973,8 @@ function createNotificationsMethods(client) {
       return client.listNotifications(
         create11(ListNotificationsRequestSchema, {
           isRead: params.unreadOnly ? false : void 0,
-          limit: params.limit ?? 20,
-          offset: params.offset ?? 0
+          first: params.first ?? 20,
+          after: params?.after
         })
       );
     },
@@ -3009,8 +3014,8 @@ function createCronSchedulesMethods(client) {
         create12(ListCronSchedulesRequestSchema, {
           configId: params.configId,
           isActive: params.isActive,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
     },
@@ -3106,8 +3111,8 @@ function createPublishBatchesMethods(client) {
       const resp = await client.listPublishBatches(
         create13(ListPublishBatchesRequestSchema, {
           status: params.status,
-          limit: params.limit ?? 50,
-          offset: params.offset ?? 0
+          first: params.first ?? 50,
+          after: params?.after
         })
       );
       return { batches: resp.batches ?? [], total: resp.total };
@@ -3480,7 +3485,7 @@ function registerSelectProjectCommand(program2, globalOpts) {
             tenantId: tenant.id,
             status: 1,
             // PROJECT_STATUS_ACTIVE
-            limit: 100
+            first: 100
           });
           for (const p of items) {
             projects.push({ id: p.id, name: p.name, tenantId: p.tenantId });
@@ -3565,7 +3570,7 @@ function registerSelectProjectCommand(program2, globalOpts) {
   );
 }
 async function provisionApiKey(client) {
-  const { items: apiKeys } = await client.identity.listApiKeys({ limit: 100 });
+  const { items: apiKeys } = await client.identity.listApiKeys({ first: 100 });
   const existing = apiKeys.find(
     (k) => k.name === CLI_API_KEY_NAME && k.isActive
   );
@@ -3969,7 +3974,7 @@ function registerMediaCommands(program2, globalOpts) {
       }
     )
   );
-  media.command("list").description("List files").option("--folder <folder>", "Filter by folder").option("--mime-type <type>", "Filter by MIME type").option("--search <query>", "Search files").option("--include-deleted", "Include soft-deleted files").option("--limit <n>", "Max results", "50").option("--offset <n>", "Offset", "0").action(
+  media.command("list").description("List files").option("--folder <folder>", "Filter by folder").option("--mime-type <type>", "Filter by MIME type").option("--search <query>", "Search files").option("--include-deleted", "Include soft-deleted files").option("--first <n>", "Max results", "50").option("--after <cursor>", "Offset", "0").action(
     withErrorHandler(
       globalOpts,
       async (flags) => {
@@ -3981,8 +3986,8 @@ function registerMediaCommands(program2, globalOpts) {
           mimeType: flags["mime-type"] ?? flags.mimeType,
           search: flags.search,
           includeDeleted: !!flags.includeDeleted,
-          limit: Number(flags.limit) || 50,
-          offset: Number(flags.offset) || 0
+          first: Number(flags.first) || 50,
+          after: flags.after
         });
         formatListProto(FileSchema, result.items, opts, {
           columns: [
@@ -4678,7 +4683,7 @@ function registerSearchCommands(program2, globalOpts) {
   program2.command("search <query>").description("Search across all records").option(
     "--models <keys>",
     "Filter to specific model keys (comma-separated)"
-  ).option("--limit <n>", "Max results", "20").action(
+  ).option("--first <n>", "Max results", "20").action(
     withErrorHandler(
       globalOpts,
       async (query, cmdOpts) => {
@@ -4687,7 +4692,7 @@ function registerSearchCommands(program2, globalOpts) {
         const modelKeys = typeof cmdOpts.models === "string" ? cmdOpts.models.split(",").map((k) => k.trim()) : void 0;
         const result = await client.records.globalSearch({
           query,
-          limit: parseInt(String(cmdOpts.limit ?? "20"), 10),
+          first: parseInt(String(cmdOpts.first ?? "20"), 10),
           modelKeys
         });
         if (opts.json || opts.jsonl) {
@@ -4861,7 +4866,7 @@ Edit the file, then run:
       async (opts) => {
         const globalFlags = globalOpts();
         const client = await createPlatformClient(globalFlags);
-        const result = await client.models.listModels({ limit: 100 });
+        const result = await client.models.listModels({ first: 100 });
         const models = result.items.map((m) => ({
           key: m.key,
           name: m.name,
@@ -5129,7 +5134,7 @@ async function reconcileConfig(client, configId, manifest, options = {}) {
   return summary;
 }
 async function reconcileModels(client, configId, models, summary, force, allowLookupRebuild, conflictOut) {
-  const existing = await client.models.listModels({ limit: 200 });
+  const existing = await client.models.listModels({ first: 200 });
   const allByKey = new Map(
     existing.items.map((m) => [m.key, m])
   );
@@ -5231,7 +5236,7 @@ function resolveEndpoint(endpoint, baseUrl) {
   return baseUrl ? `${baseUrl.replace(/\/+$/, "")}${endpoint.startsWith("/") ? "" : "/"}${endpoint}` : endpoint;
 }
 async function reconcileOperations(client, configId, operations, operationBaseUrl, summary) {
-  const existing = await client.operations.listOperations({ configId, limit: 200 });
+  const existing = await client.operations.listOperations({ configId, first: 200 });
   const existingByKey = new Map(
     (existing.operations ?? []).map((o) => [o.key, o])
   );
@@ -5311,7 +5316,7 @@ async function reconcileOperations(client, configId, operations, operationBaseUr
   }
 }
 async function reconcileHooks(client, configId, hooks, summary) {
-  const existing = await client.hooks.listHooks({ configId, limit: 200 });
+  const existing = await client.hooks.listHooks({ configId, first: 200 });
   const existingByKey = new Map(
     (existing.hooks ?? []).map((h) => [h.key, h])
   );
@@ -5359,8 +5364,8 @@ async function reconcileHooks(client, configId, hooks, summary) {
 }
 async function reconcileSegments(client, configId, segments, summary) {
   const [scoped, all] = await Promise.all([
-    client.segments.listSegments({ configId, limit: 200 }),
-    client.segments.listSegments({ limit: 200 })
+    client.segments.listSegments({ configId, first: 200 }),
+    client.segments.listSegments({ first: 200 })
   ]);
   const existingByKey = /* @__PURE__ */ new Map();
   for (const s of all.segments ?? []) {
@@ -5408,7 +5413,7 @@ async function reconcileSegments(client, configId, segments, summary) {
   }
 }
 async function reconcileCronSchedules(client, configId, schedules, summary) {
-  const existing = await client.cronSchedules.listCronSchedules({ configId, limit: 200 });
+  const existing = await client.cronSchedules.listCronSchedules({ configId, first: 200 });
   const schedulesList = existing.schedules ?? [];
   const existingByKey = new Map(
     schedulesList.map((s) => [s.key, s])
@@ -5457,7 +5462,7 @@ async function reconcileCronSchedules(client, configId, schedules, summary) {
   }
 }
 async function reconcileAuthProviders(client, providers, summary) {
-  const existing = await client.identity.listAuthProviders({ limit: 200 });
+  const existing = await client.identity.listAuthProviders({ first: 200 });
   const existingByKey = new Map(
     existing.items.map((p) => [p.key, p])
   );
@@ -5537,7 +5542,7 @@ async function reconcileDesignTokens(client, manifest, summary, publishAfterAppl
 }
 async function reconcileApiKeys(client, configKey, apiKeys, summary, rotateKeys) {
   if (apiKeys.length === 0) return;
-  const existing = await client.identity.listApiKeys({ limit: 200 });
+  const existing = await client.identity.listApiKeys({ first: 200 });
   const existingByName = new Map(
     existing.items.map((k) => [k.name, k])
   );
@@ -6084,7 +6089,7 @@ function registerPullCommand(program2, globalOpts) {
         const client = await createPlatformClient(globalOpts());
         let configKey = opts.key;
         if (!configKey) {
-          const { configs } = await client.configs.listConfigs({ limit: 50 });
+          const { configs } = await client.configs.listConfigs({ first: 50 });
           if (!configs || configs.length === 0) {
             throw new Error(
               "No configs found in this project. Push one first with `foir push`."
@@ -6193,7 +6198,7 @@ export default defineConfig(${jsonContent});
         writeFileSync3(outPath, formatted, "utf-8");
         console.log(chalk7.green(`\u2713 Exported to ${outPath}`));
         try {
-          const { items: platformModels } = await client.models.listModels({ limit: 200 });
+          const { items: platformModels } = await client.models.listModels({ first: 200 });
           for (const pm of platformModels) {
             await client.models.updateModel({
               id: pm.id,
@@ -6580,15 +6585,15 @@ import {
 } from "@eide/foir-proto-ts/models/v1/models_pb";
 function registerModelsCommands(program2, globalOpts) {
   const models = program2.command("models").description("Manage models");
-  models.command("list").description("List all models").option("--category <cat>", "Filter by category").option("--search <term>", "Search by name").option("--limit <n>", "Max results", "50").option("--offset <n>", "Skip results", "0").action(
+  models.command("list").description("List all models").option("--category <cat>", "Filter by category").option("--search <term>", "Search by name").option("--first <n>", "Max results", "50").option("--after <cursor>", "Opaque cursor from previous page", "0").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const result = await client.models.listModels({
         search: cmdOpts.search,
         category: cmdOpts.category,
-        limit: parseInt(cmdOpts.limit ?? "50", 10),
-        offset: parseInt(cmdOpts.offset ?? "0", 10)
+        first: parseInt(cmdOpts.first ?? "50", 10),
+        after: cmdOpts.after
       });
       formatListProto(ModelSchema, result.items, opts, {
         columns: [
@@ -6677,7 +6682,7 @@ function registerModelsCommands(program2, globalOpts) {
       }
     )
   );
-  models.command("versions <key>").description("List schema versions for a model").option("--limit <n>", "Max results", "20").action(
+  models.command("versions <key>").description("List schema versions for a model").option("--first <n>", "Max results", "20").action(
     withErrorHandler(
       globalOpts,
       async (key, cmdOpts) => {
@@ -6688,7 +6693,7 @@ function registerModelsCommands(program2, globalOpts) {
           throw new Error(`Model "${key}" not found.`);
         }
         const result = await client.models.listModelVersions(existing.id, {
-          limit: parseInt(cmdOpts.limit ?? "20", 10)
+          first: parseInt(cmdOpts.first ?? "20", 10)
         });
         formatListProto(ModelVersionSchema, result.items, opts, {
           columns: [
@@ -6889,14 +6894,14 @@ function registerRecordsCommands(program2, globalOpts) {
       }
     )
   );
-  records.command("versions <id>").description("List versions for a record").option("--limit <n>", "Max results", "20").action(
+  records.command("versions <id>").description("List versions for a record").option("--first <n>", "Max results", "20").action(
     withErrorHandler(
       globalOpts,
       async (parentId, cmdOpts) => {
         const opts = globalOpts();
         const client = await createPlatformClient(opts);
         const result = await client.records.listRecordVersions(parentId, {
-          limit: parseInt(cmdOpts.limit ?? "20", 10)
+          first: parseInt(cmdOpts.first ?? "20", 10)
         });
         formatListProto(RecordSchema, result.items, opts, {
           columns: [
@@ -6986,15 +6991,15 @@ function registerCustomersCommands(program2, globalOpts) {
   customers.command("list").description("List customers").option(
     "--status <status>",
     "Filter by status (ACTIVE, PENDING, SUSPENDED)"
-  ).option("--search <term>", "Search by email").option("--limit <n>", "Max results", "20").option("--offset <n>", "Skip results", "0").action(
+  ).option("--search <term>", "Search by email").option("--first <n>", "Max results", "20").option("--after <cursor>", "Opaque cursor from previous page", "0").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const result = await client.identity.listCustomers({
         status: cmdOpts.status ? statusMap[cmdOpts.status.toUpperCase()] : void 0,
         search: cmdOpts.search,
-        limit: parseInt(cmdOpts.limit ?? "20", 10),
-        offset: parseInt(cmdOpts.offset ?? "0", 10)
+        first: parseInt(cmdOpts.first ?? "20", 10),
+        after: cmdOpts.after
       });
       formatListProto(CustomerSchema, result.items, opts, {
         columns: [
@@ -7026,7 +7031,7 @@ function registerCustomersCommands(program2, globalOpts) {
       if (idOrEmail.includes("@")) {
         const list = await client.identity.listCustomers({
           search: idOrEmail,
-          limit: 1
+          first: 1
         });
         customer = list.items[0] ?? null;
       } else {
@@ -7179,14 +7184,14 @@ import {
 } from "@eide/foir-proto-ts/operations/v1/operations_pb";
 function registerOperationsCommands(program2, globalOpts) {
   const operations = program2.command("operations").description("Manage operations");
-  operations.command("list").description("List operations").option("--category <cat>", "Filter by category").option("--active", "Only active operations").option("--limit <n>", "Max results", "50").action(
+  operations.command("list").description("List operations").option("--category <cat>", "Filter by category").option("--active", "Only active operations").option("--first <n>", "Max results", "50").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const data = await client.operations.listOperations({
         category: cmdOpts.category,
         isActive: cmdOpts.active ? true : void 0,
-        limit: parseInt(String(cmdOpts.limit ?? "50"), 10)
+        first: parseInt(String(cmdOpts.first ?? "50"), 10)
       });
       formatListProto(OperationSchema, data.operations, opts, {
         columns: [
@@ -7253,13 +7258,13 @@ function registerOperationsCommands(program2, globalOpts) {
       }
     )
   );
-  operations.command("dead-letters").description("List failed operations in the dead letter queue").option("--operation <key>", "Filter by operation key").option("--limit <n>", "Max results", "20").action(
+  operations.command("dead-letters").description("List failed operations in the dead letter queue").option("--operation <key>", "Filter by operation key").option("--first <n>", "Max results", "20").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const data = await client.operations.listDeadLetterEntries({
         operationKey: cmdOpts.operation,
-        limit: parseInt(cmdOpts.limit ?? "20", 10)
+        first: parseInt(cmdOpts.first ?? "20", 10)
       });
       formatListProto(DeadLetterEntrySchema, data.entries, opts, {
         columns: [
@@ -7315,14 +7320,14 @@ import {
 } from "@eide/foir-proto-ts/segments/v1/segments_pb";
 function registerSegmentsCommands(program2, globalOpts) {
   const segments = program2.command("segments").description("Manage segments");
-  segments.command("list").description("List segments").option("--active", "Only active segments").option("--limit <n>", "Max results", "50").option("--offset <n>", "Skip results", "0").action(
+  segments.command("list").description("List segments").option("--active", "Only active segments").option("--first <n>", "Page size", "50").option("--after <cursor>", "Opaque cursor from previous page").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const data = await client.segments.listSegments({
         isActive: cmdOpts.active ? true : void 0,
-        limit: parseInt(String(cmdOpts.limit ?? "50"), 10),
-        offset: parseInt(String(cmdOpts.offset ?? "0"), 10)
+        first: parseInt(String(cmdOpts.first ?? "50"), 10),
+        after: cmdOpts.after
       });
       formatListProto(SegmentSchema, data.segments, opts, {
         columns: [
@@ -7443,13 +7448,13 @@ function registerSegmentsCommands(program2, globalOpts) {
 import { CronScheduleSchema } from "@eide/foir-proto-ts/schedules/v1/schedules_pb";
 function registerSchedulesCommands(program2, globalOpts) {
   const schedules = program2.command("schedules").description("Manage schedules");
-  schedules.command("list").description("List schedules").option("--active", "Only active schedules").option("--limit <n>", "Max results", "50").action(
+  schedules.command("list").description("List schedules").option("--active", "Only active schedules").option("--first <n>", "Max results", "50").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const data = await client.cronSchedules.listCronSchedules({
         isActive: cmdOpts.active ? true : void 0,
-        limit: parseInt(String(cmdOpts.limit ?? "50"), 10)
+        first: parseInt(String(cmdOpts.first ?? "50"), 10)
       });
       formatListProto(CronScheduleSchema, data.schedules, opts, {
         columns: [
@@ -7595,12 +7600,12 @@ import { toJson as toJson4 } from "@bufbuild/protobuf";
 import { ApiKeySchema } from "@eide/foir-proto-ts/identity/v1/identity_pb";
 function registerApiKeysCommands(program2, globalOpts) {
   const apiKeys = program2.command("api-keys").description("Manage API keys");
-  apiKeys.command("list").description("List API keys").option("--include-inactive", "Include revoked/inactive keys").option("--search <term>", "Search by name").option("--limit <n>", "Max results", "50").action(
+  apiKeys.command("list").description("List API keys").option("--include-inactive", "Include revoked/inactive keys").option("--search <term>", "Search by name").option("--first <n>", "Max results", "50").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const result = await client.identity.listApiKeys({
-        limit: parseInt(String(cmdOpts.limit ?? "50"), 10)
+        first: parseInt(String(cmdOpts.first ?? "50"), 10)
       });
       formatListProto(ApiKeySchema, result.items, opts, {
         columns: [
@@ -8019,7 +8024,7 @@ function registerEmbeddingsCommands(program2, globalOpts) {
   );
   embeddings.command("search").description("Search by vector similarity").requiredOption(
     "-d, --data <json>",
-    'Search input as JSON: {"queryVector":[\u2026],"modelKey":"\u2026","limit":10}'
+    'Search input as JSON: {"queryVector":[\u2026],"modelKey":"\u2026","first":10}'
   ).action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
@@ -8035,7 +8040,7 @@ function registerEmbeddingsCommands(program2, globalOpts) {
       const results = await client.records.searchEmbeddings({
         queryVector: input.queryVector,
         modelKey: input.modelKey,
-        limit: input.limit
+        first: input.first
       });
       if (opts.json || opts.jsonl) {
         formatOutput(results, opts);
@@ -8081,7 +8086,7 @@ function registerEmbeddingsCommands(program2, globalOpts) {
       }
     })
   );
-  embeddings.command("similar <recordId>").description("Find records similar to the given record").option("--model-key <key>", "Limit matches to a specific model").option("--limit <n>", "Maximum results (default: 10)").action(
+  embeddings.command("similar <recordId>").description("Find records similar to the given record").option("--model-key <key>", "Limit matches to a specific model").option("--first <n>", "Page size").action(
     withErrorHandler(
       globalOpts,
       async (recordId, cmdOpts) => {
@@ -8090,7 +8095,7 @@ function registerEmbeddingsCommands(program2, globalOpts) {
         const results = await client.records.findSimilarRecords({
           recordId,
           modelKey: cmdOpts.modelKey,
-          limit: cmdOpts.limit ? parseInt(String(cmdOpts.limit), 10) : void 0
+          first: cmdOpts.first ? parseInt(String(cmdOpts.first), 10) : void 0
         });
         if (opts.json || opts.jsonl) {
           formatOutput(results, opts);
@@ -8118,7 +8123,7 @@ import {
 } from "@eide/foir-proto-ts/hooks/v1/hooks_pb";
 function registerHooksCommands(program2, globalOpts) {
   const hooks = program2.command("hooks").description("Manage lifecycle hooks (event-driven webhooks)");
-  hooks.command("list").description("List hooks").option("--event <event>", "Filter by event name").option("--active", "Show only active hooks").option("--inactive", "Show only inactive hooks").option("--limit <n>", "Maximum results (default: 50)").option("--offset <n>", "Pagination offset").action(
+  hooks.command("list").description("List hooks").option("--event <event>", "Filter by event name").option("--active", "Show only active hooks").option("--inactive", "Show only inactive hooks").option("--first <n>", "Page size").option("--after <cursor>", "Opaque cursor from previous page").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
@@ -8128,8 +8133,8 @@ function registerHooksCommands(program2, globalOpts) {
       const resp = await client.hooks.listHooks({
         event: cmdOpts.event,
         isActive,
-        limit: cmdOpts.limit ? parseInt(String(cmdOpts.limit), 10) : void 0,
-        offset: cmdOpts.offset ? parseInt(String(cmdOpts.offset), 10) : void 0
+        first: cmdOpts.first ? parseInt(String(cmdOpts.first), 10) : void 0,
+        after: cmdOpts.after
       });
       formatListProto(HookSchema, resp.hooks ?? [], opts, {
         columns: [
@@ -8243,7 +8248,7 @@ function registerHooksCommands(program2, globalOpts) {
       }
     )
   );
-  hooks.command("deliveries <hookId>").description("List recent deliveries for a hook").option("--status <status>", "Filter by status (success / failed / pending)").option("--limit <n>", "Maximum results (default: 50)").option("--offset <n>", "Pagination offset").action(
+  hooks.command("deliveries <hookId>").description("List recent deliveries for a hook").option("--status <status>", "Filter by status (success / failed / pending)").option("--first <n>", "Page size").option("--after <cursor>", "Opaque cursor from previous page").action(
     withErrorHandler(
       globalOpts,
       async (hookId, cmdOpts) => {
@@ -8252,8 +8257,8 @@ function registerHooksCommands(program2, globalOpts) {
         const resp = await client.hooks.listHookDeliveries({
           hookId,
           status: cmdOpts.status,
-          limit: cmdOpts.limit ? parseInt(String(cmdOpts.limit), 10) : void 0,
-          offset: cmdOpts.offset ? parseInt(String(cmdOpts.offset), 10) : void 0
+          first: cmdOpts.first ? parseInt(String(cmdOpts.first), 10) : void 0,
+          after: cmdOpts.after
         });
         formatListProto(HookDeliverySchema, resp.deliveries ?? [], opts, {
           columns: [
@@ -8326,14 +8331,14 @@ function parseScheduledAt(value) {
 }
 function registerRolloutsCommands(program2, globalOpts) {
   const rollouts = program2.command("rollouts").description("Manage bulk scheduled publishing rollouts");
-  rollouts.command("list").description("List rollouts").option("--status <status>", "Filter by status").option("--limit <n>", "Maximum results (default: 50)").option("--offset <n>", "Pagination offset").action(
+  rollouts.command("list").description("List rollouts").option("--status <status>", "Filter by status").option("--first <n>", "Page size").option("--after <cursor>", "Opaque cursor from previous page").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const { batches } = await client.publishBatches.listPublishBatches({
         status: cmdOpts.status,
-        limit: cmdOpts.limit ? parseInt(String(cmdOpts.limit), 10) : void 0,
-        offset: cmdOpts.offset ? parseInt(String(cmdOpts.offset), 10) : void 0
+        first: cmdOpts.first ? parseInt(String(cmdOpts.first), 10) : void 0,
+        after: cmdOpts.after
       });
       formatListProto(PublishBatchSchema, batches, opts, {
         columns: [
@@ -8590,13 +8595,13 @@ function registerRolloutsCommands(program2, globalOpts) {
 import { LocaleSchema } from "@eide/foir-proto-ts/settings/v1/settings_pb";
 function registerLocalesCommands(program2, globalOpts) {
   const locales = program2.command("locales").description("Manage locales");
-  locales.command("list").description("List locales").option("--include-inactive", "Include inactive locales").option("--limit <n>", "Max results", "50").action(
+  locales.command("list").description("List locales").option("--include-inactive", "Include inactive locales").option("--first <n>", "Max results", "50").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const result = await client.settings.listLocales({
         includeInactive: !!cmdOpts.includeInactive,
-        limit: parseInt(String(cmdOpts.limit ?? "50"), 10)
+        first: parseInt(String(cmdOpts.first ?? "50"), 10)
       });
       formatListProto(LocaleSchema, result.locales, opts, {
         columns: [
@@ -8897,13 +8902,13 @@ function registerDesignTokensCommands(program2, globalOpts) {
 import { VariantCatalogEntrySchema } from "@eide/foir-proto-ts/settings/v1/settings_pb";
 function registerVariantCatalogCommands(program2, globalOpts) {
   const catalog = program2.command("variant-catalog").description("Manage variant catalog entries (markets, devices, locales)");
-  catalog.command("list").description("List variant catalog entries").option("--active", "Only active entries").option("--limit <n>", "Max results", "50").action(
+  catalog.command("list").description("List variant catalog entries").option("--active", "Only active entries").option("--first <n>", "Max results", "50").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const result = await client.settings.listVariantCatalog({
         isActive: cmdOpts.active ? true : void 0,
-        limit: parseInt(String(cmdOpts.limit ?? "50"), 10)
+        first: parseInt(String(cmdOpts.first ?? "50"), 10)
       });
       formatListProto(VariantCatalogEntrySchema, result.entries, opts, {
         columns: [
@@ -8933,7 +8938,7 @@ function registerVariantCatalogCommands(program2, globalOpts) {
       if (isUUID(idOrKey)) {
         result = await client.settings.getVariantCatalogEntry(idOrKey);
       } else {
-        const list = await client.settings.listVariantCatalog({ limit: 200 });
+        const list = await client.settings.listVariantCatalog({ first: 200 });
         result = list.entries.find(
           (e) => e.key === idOrKey
         ) ?? null;
@@ -9003,7 +9008,7 @@ import {
 } from "@eide/foir-proto-ts/storage/v1/storage_pb";
 function registerFilesCommands(program2, globalOpts) {
   const files = program2.command("files").description("Manage files (for upload, use `foir media upload`)");
-  files.command("list").description("List files").option("--folder <folder>", "Filter by folder").option("--mime-type <type>", "Filter by MIME type").option("--search <term>", "Search by filename").option("--limit <n>", "Max results", "50").option("--offset <n>", "Skip results", "0").action(
+  files.command("list").description("List files").option("--folder <folder>", "Filter by folder").option("--mime-type <type>", "Filter by MIME type").option("--search <term>", "Search by filename").option("--first <n>", "Max results", "50").option("--after <cursor>", "Opaque cursor from previous page", "0").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
@@ -9011,8 +9016,8 @@ function registerFilesCommands(program2, globalOpts) {
         folder: cmdOpts.folder,
         mimeType: cmdOpts.mimeType,
         search: cmdOpts.search,
-        limit: parseInt(cmdOpts.limit ?? "50", 10),
-        offset: parseInt(cmdOpts.offset ?? "0", 10)
+        first: parseInt(cmdOpts.first ?? "50", 10),
+        after: cmdOpts.after
       });
       formatListProto(FileSchema2, data.items, opts, {
         columns: [
@@ -9125,14 +9130,14 @@ function formatBytes(bytes) {
 import { NoteSchema } from "@eide/foir-proto-ts/settings/v1/settings_pb";
 function registerNotesCommands(program2, globalOpts) {
   const notes = program2.command("notes").description("Manage notes and comments");
-  notes.command("list").description("List notes for an entity").requiredOption("--entity-type <type>", "Entity type (e.g. record, model)").requiredOption("--entity-id <id>", "Entity ID").option("--include-resolved", "Include resolved notes").option("--limit <n>", "Max results", "20").action(
+  notes.command("list").description("List notes for an entity").requiredOption("--entity-type <type>", "Entity type (e.g. record, model)").requiredOption("--entity-id <id>", "Entity ID").option("--include-resolved", "Include resolved notes").option("--first <n>", "Max results", "20").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const data = await client.settings.listNotes({
         entityType: cmdOpts.entityType,
         entityId: cmdOpts.entityId,
-        limit: parseInt(String(cmdOpts.limit ?? "20"), 10)
+        first: parseInt(String(cmdOpts.first ?? "20"), 10)
       });
       formatListProto(NoteSchema, data.notes, opts, {
         columns: [
@@ -9224,13 +9229,13 @@ function registerNotesCommands(program2, globalOpts) {
 import { NotificationSchema } from "@eide/foir-proto-ts/notifications/v1/notifications_pb";
 function registerNotificationsCommands(program2, globalOpts) {
   const notifications = program2.command("notifications").description("Manage notifications");
-  notifications.command("list").description("List notifications").option("--unread", "Only unread notifications").option("--limit <n>", "Max results", "20").action(
+  notifications.command("list").description("List notifications").option("--unread", "Only unread notifications").option("--first <n>", "Max results", "20").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const data = await client.notifications.listNotifications({
         unreadOnly: !!cmdOpts.unread,
-        limit: parseInt(String(cmdOpts.limit ?? "20"), 10)
+        first: parseInt(String(cmdOpts.first ?? "20"), 10)
       });
       if (!(opts.json || opts.jsonl || opts.quiet)) {
         console.log(`Unread: ${data.unreadCount}
@@ -9288,14 +9293,14 @@ function registerNotificationsCommands(program2, globalOpts) {
 import { ConfigSchema } from "@eide/foir-proto-ts/configs/v1/configs_pb";
 function registerConfigsCommands(program2, globalOpts) {
   const configs = program2.command("configs").description("Manage configs (apps, webhooks)");
-  configs.command("list").description("List configs").option("--type <type>", "Filter by config type").option("--enabled", "Only enabled configs").option("--limit <n>", "Max results", "50").action(
+  configs.command("list").description("List configs").option("--type <type>", "Filter by config type").option("--enabled", "Only enabled configs").option("--first <n>", "Max results", "50").action(
     withErrorHandler(globalOpts, async (cmdOpts) => {
       const opts = globalOpts();
       const client = await createPlatformClient(opts);
       const data = await client.configs.listConfigs({
         configType: cmdOpts.type,
         enabled: cmdOpts.enabled ? true : void 0,
-        limit: parseInt(String(cmdOpts.limit ?? "50"), 10)
+        first: parseInt(String(cmdOpts.first ?? "50"), 10)
       });
       formatListProto(ConfigSchema, data.configs, opts, {
         columns: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eide/foir-cli",
-  "version": "0.30.1",
+  "version": "0.31.0",
   "description": "Universal platform CLI for Foir platform",
   "type": "module",
   "publishConfig": {
@@ -50,7 +50,7 @@
     "@bufbuild/protovalidate": "^1.1.1",
     "@connectrpc/connect": "^2.0.0",
     "@connectrpc/connect-node": "^2.0.0",
-    "@eide/foir-proto-ts": "^0.77.0",
+    "@eide/foir-proto-ts": "^0.78.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "dotenv": "^16.4.5",