@to11ai/sdk 3.0.0-rc.8 → 3.0.0-rc.9

package/dist/client.cjs

@@ -39,6 +39,8 @@ var __export = (target, all) => {
 // src/client.ts
 var exports_client = {};
 __export(exports_client, {
+  iterateCursorPages: () => import_pagination.iterateCursorPages,
+  iterateCursorItems: () => import_pagination.iterateCursorItems,
   gatewayPromptHeaders: () => import_gateway2.gatewayPromptHeaders,
   gatewayAuthHeaders: () => import_gateway2.gatewayAuthHeaders,
   createClient: () => createClient,
@@ -72,6 +74,7 @@ var import_transport = require("./transport");
 var import_context2 = require("./context");
 var import_errors = require("./errors");
 var import_gateway2 = require("./gateway");
+var import_pagination = require("./pagination");
 var import_resource3 = require("./projectEnvironments/resource");
 var import_resource4 = require("./prompts/resource");
 var import_types2 = require("./prompts/types");

package/dist/client.d.ts

@@ -8,6 +8,8 @@ export type { PromptHasNoVersionsReason, PromptNotFoundReason, PromptPolicyViola
 export { LabelNotFoundError, PromptHasNoVersionsError, PromptNotFoundError, PromptPolicyViolationError, To11aiApiError, To11aiAuthError, To11aiError, To11aiNetworkError, To11aiRateLimitError, To11aiValidationError, UnknownRoleError, } from "./errors";
 export type { ConvertMessagesOptions, GatewayAuthOptions } from "./gateway";
 export { gatewayAuthHeaders, gatewayPromptHeaders } from "./gateway";
+export type { CursorPaginatedResult, CursorPaginationInfo, FetchCursorPage, } from "./pagination";
+export { iterateCursorItems, iterateCursorPages } from "./pagination";
 export type { ArchiveProjectEnvironmentInput, ArchiveProjectEnvironmentResult, CreateProjectEnvironmentInput, CreateProjectEnvironmentResult, GetProjectEnvironmentInput, GetProjectEnvironmentResult, ListProjectEnvironmentsInput, ListProjectEnvironmentsResult, ProjectEnvironment, RestoreProjectEnvironmentInput, RestoreProjectEnvironmentResult, UpdateProjectEnvironmentInput, UpdateProjectEnvironmentResult, } from "./projectEnvironments/resource";
 export { ProjectEnvironmentResource } from "./projectEnvironments/resource";
 export type { PromptResourceConfig } from "./prompts/resource";

package/dist/client.js

@@ -26,6 +26,7 @@ import {
   UnknownRoleError
 } from "./errors";
 import { gatewayAuthHeaders as gatewayAuthHeaders2, gatewayPromptHeaders } from "./gateway";
+import { iterateCursorItems, iterateCursorPages } from "./pagination";
 import { ProjectEnvironmentResource as ProjectEnvironmentResource2 } from "./projectEnvironments/resource";
 import { PromptResource as PromptResource2 } from "./prompts/resource";
 import { ENV_SLUG_REGEX as ENV_SLUG_REGEX2 } from "./prompts/types";
@@ -129,6 +130,8 @@ function createClient(options = {}) {
   };
 }
 export {
+  iterateCursorPages,
+  iterateCursorItems,
   gatewayPromptHeaders,
   gatewayAuthHeaders2 as gatewayAuthHeaders,
   createClient,

package/dist/generated/types.gen.d.ts

@@ -1695,7 +1695,7 @@ export type ApiKeysListApiKeysData = {
         expiry?: string | null;
         q?: string | null;
         cursor?: string | null;
-        limit: string;
+        limit?: number | null;
         includeRevoked: 'true' | 'false';
         includeCounts: 'true' | 'false';
     };
@@ -1765,7 +1765,7 @@ export type ApiKeysListApiKeysResponses = {
                 revoked: number;
                 rotating: number;
             };
-            keys: Array<{
+            items: Array<{
                 calls7d: number;
                 createdAt: string;
                 createdBy: {
@@ -1797,7 +1797,10 @@ export type ApiKeysListApiKeysResponses = {
                 status: 'active' | 'revoked' | 'rotating' | 'expired';
                 workspaceId: string | null;
             }>;
-            nextCursor: string | null;
+            pagination: {
+                limit: number;
+                nextCursor: string | null;
+            };
             viewerScopeAccess: 'none' | 'scoped' | 'full';
         } | null;
         error: {
@@ -4530,8 +4533,8 @@ export type OrgAuditListOrgAuditEventsData = {
         workspace_id?: string | null;
         since?: string | null;
         until?: string | null;
-        limit?: string | null;
         cursor?: string | null;
+        limit?: number | null;
     };
     url: '/v1/orgs/{orgId}/audit';
 };
@@ -4609,6 +4612,7 @@ export type OrgAuditListOrgAuditEventsResponses = {
                 workspaceId: string | null;
             }>;
             pagination: {
+                limit: number;
                 nextCursor: string | null;
             };
         } | null;
@@ -6515,12 +6519,10 @@ export type ProjectsListProjectsByOrgData = {
         orgId: string;
     };
     query?: {
-        page?: number | null;
+        cursor?: string | null;
         limit?: number | null;
         search?: string | null;
-        sortDir?: 'asc' | 'desc' | null;
         status?: string | null;
-        sortBy?: 'createdAt' | 'updatedAt' | 'name' | 'slug' | null;
         workspaceSlug?: string | null;
         slug?: string | null;
     };
@@ -6583,19 +6585,25 @@ export type ProjectsListProjectsByOrgResponses = {
      */
     200: {
         code: number;
-        data: Array<{
-            createdAt: string;
-            id: string;
-            name: string;
-            organizationId: string;
-            slug: string;
-            status: 'active' | 'archived' | 'deleted';
-            updatedAt: string;
-            workspaceId: string;
-            workspaceName: string;
-            workspaceSlug: string;
-            workspaceStatus: 'active' | 'archived' | 'deleted';
-        }> | null;
+        data: {
+            items: Array<{
+                createdAt: string;
+                id: string;
+                name: string;
+                organizationId: string;
+                slug: string;
+                status: 'active' | 'archived' | 'deleted';
+                updatedAt: string;
+                workspaceId: string;
+                workspaceName: string;
+                workspaceSlug: string;
+                workspaceStatus: 'active' | 'archived' | 'deleted';
+            }>;
+            pagination: {
+                limit: number;
+                nextCursor: string | null;
+            };
+        } | null;
         error: {
             code: string;
             details?: unknown | null;

package/dist/generated/zod.gen.d.ts

@@ -1338,7 +1338,7 @@ export declare const zApiKeysListApiKeysQuery: z.ZodObject<{
     expiry: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     q: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    limit: z.ZodString;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     includeRevoked: z.ZodEnum<{
         true: "true";
         false: "false";
@@ -1360,7 +1360,7 @@ export declare const zApiKeysListApiKeysResponse: z.ZodObject<{
             revoked: z.ZodNumber;
             rotating: z.ZodNumber;
         }, z.core.$strip>;
-        keys: z.ZodArray<z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
             calls7d: z.ZodNumber;
             createdAt: z.ZodString;
             createdBy: z.ZodNullable<z.ZodObject<{
@@ -1409,7 +1409,10 @@ export declare const zApiKeysListApiKeysResponse: z.ZodObject<{
             }>;
             workspaceId: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>;
-        nextCursor: z.ZodNullable<z.ZodString>;
+        pagination: z.ZodObject<{
+            limit: z.ZodInt;
+            nextCursor: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
         viewerScopeAccess: z.ZodEnum<{
             none: "none";
             scoped: "scoped";
@@ -2743,8 +2746,8 @@ export declare const zOrgAuditListOrgAuditEventsQuery: z.ZodObject<{
     workspace_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     since: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     until: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    limit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
 }, z.core.$strip>;
 /**
  * Success
@@ -2782,6 +2785,7 @@ export declare const zOrgAuditListOrgAuditEventsResponse: z.ZodObject<{
             workspaceId: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>;
         pagination: z.ZodObject<{
+            limit: z.ZodInt;
             nextCursor: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>;
     }, z.core.$strip>>;
@@ -3787,20 +3791,10 @@ export declare const zProjectsListProjectsByOrgPath: z.ZodObject<{
     orgId: z.ZodString;
 }, z.core.$strip>;
 export declare const zProjectsListProjectsByOrgQuery: z.ZodObject<{
-    page: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     limit: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     search: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    sortDir: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        asc: "asc";
-        desc: "desc";
-    }>>>;
     status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    sortBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        name: "name";
-        createdAt: "createdAt";
-        updatedAt: "updatedAt";
-        slug: "slug";
-    }>>>;
     workspaceSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
@@ -3809,27 +3803,33 @@ export declare const zProjectsListProjectsByOrgQuery: z.ZodObject<{
  */
 export declare const zProjectsListProjectsByOrgResponse: z.ZodObject<{
     code: z.ZodNumber;
-    data: z.ZodNullable<z.ZodArray<z.ZodObject<{
-        createdAt: z.ZodISODateTime;
-        id: z.ZodString;
-        name: z.ZodString;
-        organizationId: z.ZodString;
-        slug: z.ZodString;
-        status: z.ZodEnum<{
-            active: "active";
-            archived: "archived";
-            deleted: "deleted";
-        }>;
-        updatedAt: z.ZodISODateTime;
-        workspaceId: z.ZodString;
-        workspaceName: z.ZodString;
-        workspaceSlug: z.ZodString;
-        workspaceStatus: z.ZodEnum<{
-            active: "active";
-            archived: "archived";
-            deleted: "deleted";
-        }>;
-    }, z.core.$strip>>>;
+    data: z.ZodNullable<z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            createdAt: z.ZodISODateTime;
+            id: z.ZodString;
+            name: z.ZodString;
+            organizationId: z.ZodString;
+            slug: z.ZodString;
+            status: z.ZodEnum<{
+                active: "active";
+                archived: "archived";
+                deleted: "deleted";
+            }>;
+            updatedAt: z.ZodISODateTime;
+            workspaceId: z.ZodString;
+            workspaceName: z.ZodString;
+            workspaceSlug: z.ZodString;
+            workspaceStatus: z.ZodEnum<{
+                active: "active";
+                archived: "archived";
+                deleted: "deleted";
+            }>;
+        }, z.core.$strip>>;
+        pagination: z.ZodObject<{
+            limit: z.ZodInt;
+            nextCursor: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
     error: z.ZodNullable<z.ZodObject<{
         code: z.ZodString;
         details: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;

package/dist/pagination.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Keyset paging, as every cursor list in the API answers it. `nextCursor` is
+ * the opaque cursor of the next page and `null` on the last one; `limit` is
+ * the page size the server applied (its default when the call passed none,
+ * clamped to its max).
+ */
+export interface CursorPaginationInfo {
+    nextCursor: string | null;
+    limit: number;
+}
+/** One page of a cursor list: `{ items, pagination: { nextCursor, limit } }`. */
+export interface CursorPaginatedResult<T> {
+    items: T[];
+    pagination: CursorPaginationInfo;
+}
+/**
+ * Fetches one page. `cursor` is `undefined` for the first page and the
+ * previous page's `pagination.nextCursor` after that.
+ */
+export type FetchCursorPage<T> = (cursor: string | undefined) => Promise<CursorPaginatedResult<T>>;
+/**
+ * Walks a cursor list page by page, yielding each page as the server returned
+ * it. Stops after the page whose `nextCursor` is `null` or empty. Throws a
+ * `To11aiError` when the server hands back a cursor it already returned, so a
+ * misbehaving endpoint cannot loop the caller forever.
+ */
+export declare function iterateCursorPages<T>(fetchPage: FetchCursorPage<T>): AsyncGenerator<CursorPaginatedResult<T>, void, undefined>;
+/**
+ * Walks a cursor list and yields its items one by one, across every page.
+ * Same stop rules as `iterateCursorPages`.
+ */
+export declare function iterateCursorItems<T>(fetchPage: FetchCursorPage<T>): AsyncGenerator<T, void, undefined>;

package/dist/prompts/resource.cjs

@@ -44,6 +44,7 @@ __export(exports_resource, {
 module.exports = __toCommonJS(exports_resource);
 var import_errors = require("../errors");
 var import_zod = require("../generated/zod.gen");
+var import_pagination = require("../pagination");
 var import_shape = require("./shape");
 var import_types = require("./types");
 var LATEST_PROMPT_LABEL = "latest";
@@ -170,6 +171,9 @@ class PromptResource {
     const envelope = await this.transport.request("GET", `${getProjectPromptPath(projectId, promptId)}/versions`, { query });
     return unwrap(envelope);
   }
+  iterateVersions(input) {
+    return import_pagination.iterateCursorItems((cursor) => this.listVersions({ ...input, cursor }));
+  }
   async getVersion(input) {
     const { projectId: perCallProjectId, promptId, versionNumber } = input;
     const projectId = this.resolveProjectId(perCallProjectId);

package/dist/prompts/resource.d.ts

@@ -1,7 +1,7 @@
 import type { Transport } from "../transport";
 import type { AnthropicRenderedPrompt, OpenAiRenderedPrompt, RenderResult } from "./shape";
-import type { ArchivePromptInput, ArchivePromptResult, CreatePromptInput, CreatePromptResult, CreatePromptVersionInput, CreatePromptVersionResult, GetPromptInput, GetPromptResult, GetPromptVersionInput, GetPromptVersionResult, ListPromptLabelsInput, ListPromptLabelsResult, ListPromptsInput, ListPromptsResult, ListPromptVersionsInput, ListPromptVersionsResult, PaginatedResult, RenderFormat, RenderOptions, UnknownRoleMode, UpdatePromptInput, UpdatePromptResult } from "./types";
-export type { ArchivePromptInput, ArchivePromptResult, BlockRenderRecord, ChatMessage, ChatRole, CreatePromptInput, CreatePromptResult, CreatePromptVersionInput, CreatePromptVersionResult, CursorPaginatedResult, CursorPaginationInfo, GetPromptInput, GetPromptResult, GetPromptVersionInput, GetPromptVersionResult, ListPromptLabelsInput, ListPromptLabelsResult, ListPromptsInput, ListPromptsResult, ListPromptVersionsInput, ListPromptVersionsResult, PaginatedResult, PaginationInfo, Prompt, PromptFormat, PromptLabelPointer, PromptStatus, PromptVersion, PromptVersionSummary, RenderedChatMessage, RenderedPrompt, RenderFormat, RenderOptions, ResolvedPrompt, ResolvedPromptEnvelope, ResolvedToolCall, ResolvedToolDefinition, RowError, UnknownRoleMode, UpdatePromptInput, UpdatePromptResult, } from "./types";
+import type { ArchivePromptInput, ArchivePromptResult, CreatePromptInput, CreatePromptResult, CreatePromptVersionInput, CreatePromptVersionResult, GetPromptInput, GetPromptResult, GetPromptVersionInput, GetPromptVersionResult, IterateVersionsInput, ListPromptLabelsInput, ListPromptLabelsResult, ListPromptsInput, ListPromptsResult, ListPromptVersionsInput, ListPromptVersionsResult, PaginatedResult, PromptVersionSummary, RenderFormat, RenderOptions, UnknownRoleMode, UpdatePromptInput, UpdatePromptResult } from "./types";
+export type { ArchivePromptInput, ArchivePromptResult, BlockRenderRecord, ChatMessage, ChatRole, CreatePromptInput, CreatePromptResult, CreatePromptVersionInput, CreatePromptVersionResult, CursorPaginatedResult, CursorPaginationInfo, GetPromptInput, GetPromptResult, GetPromptVersionInput, GetPromptVersionResult, IterateVersionsInput, ListPromptLabelsInput, ListPromptLabelsResult, ListPromptsInput, ListPromptsResult, ListPromptVersionsInput, ListPromptVersionsResult, PaginatedResult, PaginationInfo, Prompt, PromptFormat, PromptLabelPointer, PromptStatus, PromptVersion, PromptVersionSummary, RenderedChatMessage, RenderedPrompt, RenderFormat, RenderOptions, ResolvedPrompt, ResolvedPromptEnvelope, ResolvedToolCall, ResolvedToolDefinition, RowError, UnknownRoleMode, UpdatePromptInput, UpdatePromptResult, } from "./types";
 /**
  * Init-time config for the `render()` surface (TO11-980 / S9).
  *
@@ -48,6 +48,19 @@ export declare class PromptResource<F extends RenderFormat | undefined = undefin
      * version's content with `getVersion()`.
      */
     listVersions(input: ListPromptVersionsInput): Promise<ListPromptVersionsResult>;
+    /**
+     * Every version of a prompt, newest first, as summaries: walks
+     * `listVersions()` page by page until `pagination.nextCursor` is `null` and
+     * yields one `PromptVersionSummary` at a time. `limit` sets the page size of
+     * each request. Throws a `To11aiError` if the server repeats a cursor.
+     *
+     * ```ts
+     * for await (const version of to11.prompts.iterateVersions({ promptId })) {
+     *   console.log(version.version);
+     * }
+     * ```
+     */
+    iterateVersions(input: IterateVersionsInput): AsyncGenerator<PromptVersionSummary, void, undefined>;
     getVersion(input: GetPromptVersionInput): Promise<GetPromptVersionResult>;
     listLabels(input: ListPromptLabelsInput): Promise<ListPromptLabelsResult>;
     /**

package/dist/prompts/resource.js

@@ -1,6 +1,7 @@
 // src/prompts/resource.ts
 import { To11aiApiError, To11aiNetworkError } from "../errors";
 import { zResolvedPrompt } from "../generated/zod.gen";
+import { iterateCursorItems } from "../pagination";
 import { shapePrompt } from "./shape";
 import { ENV_SLUG_REGEX } from "./types";
 var LATEST_PROMPT_LABEL = "latest";
@@ -127,6 +128,9 @@ class PromptResource {
     const envelope = await this.transport.request("GET", `${getProjectPromptPath(projectId, promptId)}/versions`, { query });
     return unwrap(envelope);
   }
+  iterateVersions(input) {
+    return iterateCursorItems((cursor) => this.listVersions({ ...input, cursor }));
+  }
   async getVersion(input) {
     const { projectId: perCallProjectId, promptId, versionNumber } = input;
     const projectId = this.resolveProjectId(perCallProjectId);

package/dist/prompts/types.d.ts

@@ -1,4 +1,5 @@
 import type { Prompt as GenPrompt, PromptLabelPointer as GenPromptLabelPointer, PromptVersion as GenPromptVersion, PromptVersionSummary as GenPromptVersionSummary, RenderedChatPrompt as GenRenderedChatPrompt, ResolvedPrompt as GenResolvedPrompt, ResolvedToolCall as GenResolvedToolCall, ResolvedToolDefinition as GenResolvedToolDefinition } from "../generated/types.gen";
+import type { CursorPaginatedResult } from "../pagination";
 export interface RowError {
     path: ReadonlyArray<string | number>;
     code: string;
@@ -55,19 +56,7 @@ export interface PaginatedResult<T> {
     items: T[];
     pagination: PaginationInfo;
 }
-/**
- * Keyset paging, as the audit feeds use it. `nextCursor` is the opaque cursor
- * of the next page and `null` on the last one; `limit` is the page size the
- * server applied (its default when the call passed none, clamped to its max).
- */
-export interface CursorPaginationInfo {
-    nextCursor: string | null;
-    limit: number;
-}
-export interface CursorPaginatedResult<T> {
-    items: T[];
-    pagination: CursorPaginationInfo;
-}
+export type { CursorPaginatedResult, CursorPaginationInfo, } from "../pagination";
 export interface CreatePromptInput {
     projectId?: string;
     name: string;
@@ -121,6 +110,11 @@ export interface ListPromptVersionsInput {
     /** Page size. The server defaults to 50 and clamps to 100. */
     limit?: number;
 }
+/**
+ * Input of `iterateVersions()`: `listVersions()` without `cursor`, which the
+ * iterator manages. `limit` is the page size of each request.
+ */
+export type IterateVersionsInput = Omit<ListPromptVersionsInput, "cursor">;
 /**
  * One page of a prompt's versions, newest first, as summaries. Read a
  * version's content with `getVersion()`.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@to11ai/sdk",
-	"version": "3.0.0-rc.8",
+	"version": "3.0.0-rc.9",
 	"license": "MPL-2.0",
 	"repository": {
 		"type": "git",

package/src/client.ts

@@ -40,6 +40,12 @@ export {
 } from "./errors";
 export type { ConvertMessagesOptions, GatewayAuthOptions } from "./gateway";
 export { gatewayAuthHeaders, gatewayPromptHeaders } from "./gateway";
+export type {
+	CursorPaginatedResult,
+	CursorPaginationInfo,
+	FetchCursorPage,
+} from "./pagination";
+export { iterateCursorItems, iterateCursorPages } from "./pagination";
 export type {
 	ArchiveProjectEnvironmentInput,
 	ArchiveProjectEnvironmentResult,

package/src/generated/types.gen.ts

@@ -1808,7 +1808,7 @@ export type ApiKeysListApiKeysData = {
         expiry?: string | null;
         q?: string | null;
         cursor?: string | null;
-        limit: string;
+        limit?: number | null;
         includeRevoked: 'true' | 'false';
         includeCounts: 'true' | 'false';
     };
@@ -1881,7 +1881,7 @@ export type ApiKeysListApiKeysResponses = {
                 revoked: number;
                 rotating: number;
             };
-            keys: Array<{
+            items: Array<{
                 calls7d: number;
                 createdAt: string;
                 createdBy: {
@@ -1913,7 +1913,10 @@ export type ApiKeysListApiKeysResponses = {
                 status: 'active' | 'revoked' | 'rotating' | 'expired';
                 workspaceId: string | null;
             }>;
-            nextCursor: string | null;
+            pagination: {
+                limit: number;
+                nextCursor: string | null;
+            };
             viewerScopeAccess: 'none' | 'scoped' | 'full';
         } | null;
         error: {
@@ -4778,8 +4781,8 @@ export type OrgAuditListOrgAuditEventsData = {
         workspace_id?: string | null;
         since?: string | null;
         until?: string | null;
-        limit?: string | null;
         cursor?: string | null;
+        limit?: number | null;
     };
     url: '/v1/orgs/{orgId}/audit';
 };
@@ -4860,6 +4863,7 @@ export type OrgAuditListOrgAuditEventsResponses = {
                 workspaceId: string | null;
             }>;
             pagination: {
+                limit: number;
                 nextCursor: string | null;
             };
         } | null;
@@ -6853,12 +6857,10 @@ export type ProjectsListProjectsByOrgData = {
         orgId: string;
     };
     query?: {
-        page?: number | null;
+        cursor?: string | null;
         limit?: number | null;
         search?: string | null;
-        sortDir?: 'asc' | 'desc' | null;
         status?: string | null;
-        sortBy?: 'createdAt' | 'updatedAt' | 'name' | 'slug' | null;
         workspaceSlug?: string | null;
         slug?: string | null;
     };
@@ -6924,19 +6926,25 @@ export type ProjectsListProjectsByOrgResponses = {
      */
     200: {
         code: number;
-        data: Array<{
-            createdAt: string;
-            id: string;
-            name: string;
-            organizationId: string;
-            slug: string;
-            status: 'active' | 'archived' | 'deleted';
-            updatedAt: string;
-            workspaceId: string;
-            workspaceName: string;
-            workspaceSlug: string;
-            workspaceStatus: 'active' | 'archived' | 'deleted';
-        }> | null;
+        data: {
+            items: Array<{
+                createdAt: string;
+                id: string;
+                name: string;
+                organizationId: string;
+                slug: string;
+                status: 'active' | 'archived' | 'deleted';
+                updatedAt: string;
+                workspaceId: string;
+                workspaceName: string;
+                workspaceSlug: string;
+                workspaceStatus: 'active' | 'archived' | 'deleted';
+            }>;
+            pagination: {
+                limit: number;
+                nextCursor: string | null;
+            };
+        } | null;
         error: {
             code: string;
             details?: unknown | null;

package/src/generated/zod.gen.ts

@@ -1021,7 +1021,7 @@ export const zApiKeysListApiKeysQuery = z.object({
     expiry: z.string().nullish(),
     q: z.string().nullish(),
     cursor: z.string().nullish(),
-    limit: z.string(),
+    limit: z.int().nullish(),
     includeRevoked: z.enum(['true', 'false']),
     includeCounts: z.enum(['true', 'false'])
 });
@@ -1038,7 +1038,7 @@ export const zApiKeysListApiKeysResponse = z.object({
             revoked: z.number(),
             rotating: z.number()
         }),
-        keys: z.array(z.object({
+        items: z.array(z.object({
             calls7d: z.number(),
             createdAt: z.string(),
             createdBy: z.object({
@@ -1084,7 +1084,10 @@ export const zApiKeysListApiKeysResponse = z.object({
             ]),
             workspaceId: z.string().nullable()
         })),
-        nextCursor: z.string().nullable(),
+        pagination: z.object({
+            limit: z.int().gte(1).lte(100),
+            nextCursor: z.string().nullable()
+        }),
         viewerScopeAccess: z.enum([
             'none',
             'scoped',
@@ -2404,8 +2407,8 @@ export const zOrgAuditListOrgAuditEventsQuery = z.object({
     workspace_id: z.string().nullish(),
     since: z.string().nullish(),
     until: z.string().nullish(),
-    limit: z.string().nullish(),
-    cursor: z.string().nullish()
+    cursor: z.string().nullish(),
+    limit: z.int().nullish()
 });
 
 /**
@@ -2441,6 +2444,7 @@ export const zOrgAuditListOrgAuditEventsResponse = z.object({
             workspaceId: z.string().nullable()
         })),
         pagination: z.object({
+            limit: z.int().gte(1).lte(100),
             nextCursor: z.string().nullable()
         })
     }).nullable(),
@@ -3444,17 +3448,10 @@ export const zProjectsListProjectsByOrgPath = z.object({
 });
 
 export const zProjectsListProjectsByOrgQuery = z.object({
-    page: z.int().nullish(),
+    cursor: z.string().nullish(),
     limit: z.int().nullish(),
     search: z.string().nullish(),
-    sortDir: z.enum(['asc', 'desc']).nullish(),
     status: z.string().nullish(),
-    sortBy: z.enum([
-        'createdAt',
-        'updatedAt',
-        'name',
-        'slug'
-    ]).nullish(),
     workspaceSlug: z.string().nullish(),
     slug: z.string().nullish()
 });
@@ -3464,27 +3461,33 @@ export const zProjectsListProjectsByOrgQuery = z.object({
  */
 export const zProjectsListProjectsByOrgResponse = z.object({
     code: z.number(),
-    data: z.array(z.object({
-        createdAt: z.iso.datetime(),
-        id: z.string(),
-        name: z.string().min(1).max(120),
-        organizationId: z.string(),
-        slug: z.string().min(1).max(120),
-        status: z.enum([
-            'active',
-            'archived',
-            'deleted'
-        ]),
-        updatedAt: z.iso.datetime(),
-        workspaceId: z.string(),
-        workspaceName: z.string().min(1).max(120),
-        workspaceSlug: z.string().min(1).max(120),
-        workspaceStatus: z.enum([
-            'active',
-            'archived',
-            'deleted'
-        ])
-    })).nullable(),
+    data: z.object({
+        items: z.array(z.object({
+            createdAt: z.iso.datetime(),
+            id: z.string(),
+            name: z.string().min(1).max(120),
+            organizationId: z.string(),
+            slug: z.string().min(1).max(120),
+            status: z.enum([
+                'active',
+                'archived',
+                'deleted'
+            ]),
+            updatedAt: z.iso.datetime(),
+            workspaceId: z.string(),
+            workspaceName: z.string().min(1).max(120),
+            workspaceSlug: z.string().min(1).max(120),
+            workspaceStatus: z.enum([
+                'active',
+                'archived',
+                'deleted'
+            ])
+        })),
+        pagination: z.object({
+            limit: z.int().gte(1).lte(100),
+            nextCursor: z.string().nullable()
+        })
+    }).nullable(),
     error: z.object({
         code: z.string(),
         details: z.unknown().nullish(),

package/src/pagination.ts

@@ -0,0 +1,64 @@
+import { To11aiError } from "./errors";
+
+/**
+ * Keyset paging, as every cursor list in the API answers it. `nextCursor` is
+ * the opaque cursor of the next page and `null` on the last one; `limit` is
+ * the page size the server applied (its default when the call passed none,
+ * clamped to its max).
+ */
+export interface CursorPaginationInfo {
+	nextCursor: string | null;
+	limit: number;
+}
+
+/** One page of a cursor list: `{ items, pagination: { nextCursor, limit } }`. */
+export interface CursorPaginatedResult<T> {
+	items: T[];
+	pagination: CursorPaginationInfo;
+}
+
+/**
+ * Fetches one page. `cursor` is `undefined` for the first page and the
+ * previous page's `pagination.nextCursor` after that.
+ */
+export type FetchCursorPage<T> = (
+	cursor: string | undefined,
+) => Promise<CursorPaginatedResult<T>>;
+
+/**
+ * Walks a cursor list page by page, yielding each page as the server returned
+ * it. Stops after the page whose `nextCursor` is `null` or empty. Throws a
+ * `To11aiError` when the server hands back a cursor it already returned, so a
+ * misbehaving endpoint cannot loop the caller forever.
+ */
+export async function* iterateCursorPages<T>(
+	fetchPage: FetchCursorPage<T>,
+): AsyncGenerator<CursorPaginatedResult<T>, void, undefined> {
+	const seen = new Set<string>();
+	let cursor: string | undefined;
+	for (;;) {
+		const page = await fetchPage(cursor);
+		yield page;
+		const next = page.pagination.nextCursor;
+		if (next === null || next === undefined || next === "") return;
+		if (seen.has(next)) {
+			throw new To11aiError(
+				`Cursor pagination returned a cursor it already returned ("${next}"); stopping to avoid an endless loop.`,
+			);
+		}
+		seen.add(next);
+		cursor = next;
+	}
+}
+
+/**
+ * Walks a cursor list and yields its items one by one, across every page.
+ * Same stop rules as `iterateCursorPages`.
+ */
+export async function* iterateCursorItems<T>(
+	fetchPage: FetchCursorPage<T>,
+): AsyncGenerator<T, void, undefined> {
+	for await (const page of iterateCursorPages(fetchPage)) {
+		yield* page.items;
+	}
+}

package/src/prompts/resource.ts

@@ -1,5 +1,6 @@
 import { To11aiApiError, To11aiNetworkError } from "../errors";
 import { zResolvedPrompt } from "../generated/zod.gen";
+import { iterateCursorItems } from "../pagination";
 import type { ApiEnvelope, Transport } from "../transport";
 import type {
 	AnthropicRenderedPrompt,
@@ -18,6 +19,7 @@ import type {
 	GetPromptResult,
 	GetPromptVersionInput,
 	GetPromptVersionResult,
+	IterateVersionsInput,
 	ListPromptLabelsInput,
 	ListPromptLabelsResult,
 	ListPromptsInput,
@@ -25,6 +27,7 @@ import type {
 	ListPromptVersionsInput,
 	ListPromptVersionsResult,
 	PaginatedResult,
+	PromptVersionSummary,
 	RenderedChatMessage,
 	RenderedPrompt,
 	RenderFormat,
@@ -53,6 +56,7 @@ export type {
 	GetPromptResult,
 	GetPromptVersionInput,
 	GetPromptVersionResult,
+	IterateVersionsInput,
 	ListPromptLabelsInput,
 	ListPromptLabelsResult,
 	ListPromptsInput,
@@ -374,6 +378,26 @@ export class PromptResource<F extends RenderFormat | undefined = undefined> {
 		return unwrap(envelope);
 	}
 
+	/**
+	 * Every version of a prompt, newest first, as summaries: walks
+	 * `listVersions()` page by page until `pagination.nextCursor` is `null` and
+	 * yields one `PromptVersionSummary` at a time. `limit` sets the page size of
+	 * each request. Throws a `To11aiError` if the server repeats a cursor.
+	 *
+	 * ```ts
+	 * for await (const version of to11.prompts.iterateVersions({ promptId })) {
+	 *   console.log(version.version);
+	 * }
+	 * ```
+	 */
+	iterateVersions(
+		input: IterateVersionsInput,
+	): AsyncGenerator<PromptVersionSummary, void, undefined> {
+		return iterateCursorItems((cursor) =>
+			this.listVersions({ ...input, cursor }),
+		);
+	}
+
 	// ─── Get Version ──────────────────────────────────────────────────────────
 
 	async getVersion(

package/src/prompts/types.ts

@@ -8,6 +8,7 @@ import type {
 	ResolvedToolCall as GenResolvedToolCall,
 	ResolvedToolDefinition as GenResolvedToolDefinition,
 } from "../generated/types.gen";
+import type { CursorPaginatedResult } from "../pagination";
 
 export interface RowError {
 	path: ReadonlyArray<string | number>;
@@ -88,20 +89,12 @@ export interface PaginatedResult<T> {
 	pagination: PaginationInfo;
 }
 
-/**
- * Keyset paging, as the audit feeds use it. `nextCursor` is the opaque cursor
- * of the next page and `null` on the last one; `limit` is the page size the
- * server applied (its default when the call passed none, clamped to its max).
- */
-export interface CursorPaginationInfo {
-	nextCursor: string | null;
-	limit: number;
-}
-
-export interface CursorPaginatedResult<T> {
-	items: T[];
-	pagination: CursorPaginationInfo;
-}
+// The cursor page shapes are shared by every cursor list; they live in
+// `../pagination` and stay re-exported here for existing imports.
+export type {
+	CursorPaginatedResult,
+	CursorPaginationInfo,
+} from "../pagination";
 
 export interface CreatePromptInput {
 	projectId?: string;
@@ -169,6 +162,12 @@ export interface ListPromptVersionsInput {
 	limit?: number;
 }
 
+/**
+ * Input of `iterateVersions()`: `listVersions()` without `cursor`, which the
+ * iterator manages. `limit` is the page size of each request.
+ */
+export type IterateVersionsInput = Omit<ListPromptVersionsInput, "cursor">;
+
 /**
  * One page of a prompt's versions, newest first, as summaries. Read a
  * version's content with `getVersion()`.