@warmhub/sdk-ts 0.82.3 → 0.83.0

package/dist/{chunk-PMLASUR6.js → chunk-6AHGGJL6.js}

@@ -184,26 +184,6 @@ function constantTimeEqualHex(a, b) {
   return diff === 0;
 }
 
-// ../rules/src/repo-auth-scopes.ts
-var REPO_AUTH_SCOPES = [
-  "repo:read",
-  "repo:write",
-  "repo:configure",
-  "repo:admin",
-  // GH-4679: the repo-scoped twin of `org:action-callback`. A narrow capability
-  // for acknowledging a repo-scoped action run's delivery (the async webhook
-  // callback). Deliberately NOT implied by `repo:write` — a webhook handler
-  // (e.g. a component) can be granted exactly this without standing authority to
-  // write things/shapes. The callback gate currently ALSO accepts `repo:write`
-  // so existing consumers (the Veritas worker) keep acking; that broad
-  // acceptance is dropped once consumers move to this scope. Held by
-  // owner/admin roles; grantable to a token (or component manifest) on its own.
-  "repo:action-callback"
-];
-
-// ../rules/src/component-manifest-contract-internals.ts
-new Set(REPO_AUTH_SCOPES);
-
 // ../rules/src/field-name-safety.ts
 var ESCAPE_DISPLAY_MAX_CHARS = 120;
 var DANGEROUS_FORMAT_CODEPOINTS = /* @__PURE__ */ new Set([
@@ -6755,13 +6735,6 @@ function isFieldOptional(fieldKey, typeSpec) {
   return optionalByKey || normalizeOptionalTypeSpec(typeSpec).optionalByType;
 }
 
-// ../rules/src/name-charset.ts
-var RESERVED_NAME_SEGMENT_CHARS = ["?", "#", "@", ":", "$"];
-function escapeForCharClass(char) {
-  return char.replace(/[\\\]^-]/g, "\\$&");
-}
-RESERVED_NAME_SEGMENT_CHARS.map(escapeForCharClass).join("");
-
 // ../rules/src/tokens.ts
 var COMMIT_TOKEN_SYNTAX_REMOVED_MESSAGE = "$N/#N commit-token syntax is no longer supported. Use explicit names and explicit wrefs. For assertions about newly created things, create the thing with a deterministic name and set about to that wref in the same commit.";
 var ANY_TOKEN_RE = /[$#]\d+/;
@@ -7053,39 +7026,6 @@ function preflightCommitDiagnostics2(operations, options) {
   return preflightCommitDiagnostics(operations, options);
 }
 
-// ../rules/src/reserved-orgs.ts
-var RESERVED_RAW_CONTENT_TOP_LEVEL_NAMES = [
-  "_app",
-  "_static",
-  "api",
-  "health",
-  "healthz",
-  "mcp",
-  "readyz",
-  "robots.txt",
-  "sse",
-  "trpc",
-  "version"
-];
-var RESERVED_ORG_NAMES = [
-  ...RESERVED_RAW_CONTENT_TOP_LEVEL_NAMES,
-  "admin",
-  "billing",
-  "blog",
-  "docs",
-  "help",
-  "login",
-  "public",
-  "settings",
-  "signup",
-  "status",
-  "support",
-  "system",
-  "warmhub",
-  "www"
-];
-new Set(RESERVED_ORG_NAMES);
-
 // ../rules/src/shape-field-key.ts
 function foldFieldName(name) {
   const stripped = name.endsWith("?") ? name.slice(0, -1) : name;
@@ -7843,67 +7783,6 @@ function validateShapeDefinition(data, options = {}) {
   return { valid: true };
 }
 
-// ../rules/src/system-components/system.ts
-var SYSTEM_COMPONENT_ID = "com.warmhub.system";
-var COMPONENT_INSTALL_FIELDS = {
-  componentId: "string",
-  name: "string",
-  version: "string",
-  source: "string",
-  "sourceKind?": "string",
-  "sourceRef?": "string",
-  "resolvedSha?": "string",
-  "registeredComponentRef?": "string",
-  manifestHash: "string",
-  state: "string",
-  manifest: "string",
-  installedAt: "string",
-  installedByUserId: "string?",
-  "installId?": "string",
-  "updatedAt?": "string"
-};
-var COMPONENT_CONFIG_FIELDS = {};
-var SYSTEM_MANIFEST = {
-  component: {
-    id: SYSTEM_COMPONENT_ID,
-    name: "system",
-    version: "1.0.0"
-  },
-  shapes: [
-    { name: "ComponentInstall", fields: COMPONENT_INSTALL_FIELDS },
-    { name: "ComponentConfig", fields: COMPONENT_CONFIG_FIELDS }
-  ],
-  credentials: [],
-  subscriptions: [],
-  seeds: [],
-  health: {
-    requires: { shapes: ["ComponentInstall", "ComponentConfig"] }
-  },
-  teardown: {},
-  runtimeAccess: { reads: [], writes: [] }
-};
-var SYSTEM_COMPONENT = {
-  componentId: SYSTEM_COMPONENT_ID,
-  name: SYSTEM_MANIFEST.component.name,
-  version: SYSTEM_MANIFEST.component.version,
-  manifest: SYSTEM_MANIFEST,
-  installInfra: true,
-  shapes: [
-    { name: "ComponentInstall", fields: COMPONENT_INSTALL_FIELDS },
-    { name: "ComponentConfig", fields: COMPONENT_CONFIG_FIELDS }
-  ]
-};
-
-// ../rules/src/system-components/index.ts
-var SYSTEM_COMPONENTS = [
-  SYSTEM_COMPONENT
-];
-new Set(
-  SYSTEM_COMPONENTS.filter((entry) => entry.installInfra === true).flatMap(
-    (entry) => entry.shapes.map((s) => s.name)
-  )
-);
-
 // src/shape-preflight.ts
 function shapeDefinitionPreflightError(name, data, verb) {
   const result = validateShapeDefinition(
@@ -8570,7 +8449,7 @@ var SDK_DEVELOPMENT_VERSION = "0.0.0-development";
 function sdkVersionIsDevelopment(version) {
   return version === SDK_DEVELOPMENT_VERSION;
 }
-var SDK_VERSION = "0.82.3" ;
+var SDK_VERSION = "0.83.0" ;
 
 // src/component-cli.ts
 var SUPPORTED_METHODS = /* @__PURE__ */ new Set([
@@ -9400,20 +9279,31 @@ function assertPaginatedCursorAdvanced(cursor, nextCursor, seenCursors) {
     );
   }
 }
-async function* paginate(fetchPage, extractItems, initialCursor) {
+function assertIncrementalLowerBound(sinceRepoSeq) {
+  if (sinceRepoSeq === void 0) {
+    throw new WarmHubError(
+      "VALIDATION_ERROR",
+      "sinceRepoSeq is required for an incremental read"
+    );
+  }
+}
+async function* paginatePages(fetchPage, initialCursor) {
   let cursor = initialCursor;
   const seenCursors = /* @__PURE__ */ new Set();
   for (; ; ) {
     if (cursor) seenCursors.add(cursor);
     const page = await fetchPage(cursor);
-    for (const item of extractItems(page)) {
-      yield item;
-    }
+    yield page;
     if (!page.nextCursor) return;
     assertPaginatedCursorAdvanced(cursor, page.nextCursor, seenCursors);
     cursor = page.nextCursor;
   }
 }
+async function* paginate(fetchPage, extractItems, initialCursor) {
+  for await (const page of paginatePages(fetchPage, initialCursor)) {
+    yield* extractItems(page);
+  }
+}
 async function collectPaginatedPages(fetchPage, extractItems, max, initialCursor) {
   if (max !== void 0 && (!Number.isFinite(max) || Math.trunc(max) !== max || max < 0)) {
     throw new WarmHubError(
@@ -9422,11 +9312,7 @@ async function collectPaginatedPages(fetchPage, extractItems, max, initialCursor
     );
   }
   const items = [];
-  let cursor = initialCursor;
-  const seenCursors = /* @__PURE__ */ new Set();
-  for (; ; ) {
-    if (cursor) seenCursors.add(cursor);
-    const page = await fetchPage(cursor);
+  for await (const page of paginatePages(fetchPage, initialCursor)) {
     const pageItems = extractItems(page);
     if (max !== void 0 && items.length + pageItems.length > max) {
       throw new WarmHubError(
@@ -9435,7 +9321,34 @@ async function collectPaginatedPages(fetchPage, extractItems, max, initialCursor
       );
     }
     items.push(...pageItems);
-    if (!page.nextCursor) return items;
+  }
+  return items;
+}
+function assertRepoExploreBrowseMode(opts) {
+  if (opts?.slugs !== void 0) {
+    throw new WarmHubError(
+      "VALIDATION_ERROR",
+      "repo.explore pagination helpers do not support slugs mode"
+    );
+  }
+}
+async function collectIncrementalPages(fetchPage) {
+  const items = [];
+  let cursor;
+  const seenCursors = /* @__PURE__ */ new Set();
+  for (; ; ) {
+    if (cursor) seenCursors.add(cursor);
+    const page = await fetchPage(cursor);
+    items.push(...page.items);
+    if (!page.nextCursor) {
+      if (page.repoSeq === void 0) {
+        throw new WarmHubError(
+          "VALIDATION_ERROR",
+          "Incremental read completed without repoSeq"
+        );
+      }
+      return { items, repoSeq: page.repoSeq };
+    }
     assertPaginatedCursorAdvanced(cursor, page.nextCursor, seenCursors);
     cursor = page.nextCursor;
   }
@@ -9979,11 +9892,40 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Iterate installed components. Cursors resume the same query and result
+     * scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query without
+     * `cursor`.
+     */
+    listIter: (orgName, repoName, opts) => {
+      return paginate(
+        (cursor) => this.component.list(orgName, repoName, { ...opts, cursor }),
+        (page) => page.items,
+        opts?.cursor
+      );
+    },
+    /**
+     * Materialize installed components. Cursors resume the same query and
+     * result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query
+     * without `cursor`.
+     */
+    listAll: async (orgName, repoName, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages(
+        (cursor) => this.component.list(orgName, repoName, { ...pageOpts, cursor }),
+        (page) => page.items,
+        max,
+        pageOpts.cursor
+      );
+    },
     /**
      * Search registered components visible to the caller across all orgs
      * (GH-4383): public components plus private components the caller can
      * read. Distinct from listing components installed in a repo
      * (`component.list`).
+     *
+     * Cursor contract: cursors resume the same query and result scope; on
+     * `VALIDATION_ERROR` / `Invalid cursor`, restart the query without `cursor`.
      */
     search: async (query, opts) => {
       try {
@@ -9996,6 +9938,32 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Iterate global component search hits. Cursors resume the same query and
+     * result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query
+     * without `cursor`.
+     */
+    searchIter: (query, opts) => {
+      return paginate(
+        (cursor) => this.component.search(query, { ...opts, cursor }),
+        (page) => page.items,
+        opts?.cursor
+      );
+    },
+    /**
+     * Materialize global component search hits. Cursors resume the same query
+     * and result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the
+     * query without `cursor`.
+     */
+    searchAll: async (query, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages(
+        (cursor) => this.component.search(query, { ...pageOpts, cursor }),
+        (page) => page.items,
+        max,
+        pageOpts.cursor
+      );
+    },
     /**
      * Fetch one installed component by its `Org/Name` ref.
      */
@@ -10604,10 +10572,39 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Iterate organization repositories. Cursors resume the same query and
+     * result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query
+     * without `cursor`.
+     */
+    listIter: (orgName, opts) => {
+      return paginate(
+        (cursor) => this.repo.list(orgName, { ...opts, cursor }),
+        (page) => page.items,
+        opts?.cursor
+      );
+    },
+    /**
+     * Materialize organization repositories. Cursors resume the same query and
+     * result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query
+     * without `cursor`.
+     */
+    listAll: async (orgName, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages(
+        (cursor) => this.repo.list(orgName, { ...pageOpts, cursor }),
+        (page) => page.items,
+        max,
+        pageOpts.cursor
+      );
+    },
     /**
      * Search repos visible to the caller across all orgs (GH-4383): public
      * repos plus private repos the caller can read. BM25 over
      * name/description/shape vocabulary/README.
+     *
+     * Cursor contract: cursors resume the same query and result scope; on
+     * `VALIDATION_ERROR` / `Invalid cursor`, restart the query without `cursor`.
      */
     search: async (query, opts) => {
       try {
@@ -10620,6 +10617,32 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Iterate global repository search hits. Cursors resume the same query and
+     * result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query
+     * without `cursor`.
+     */
+    searchIter: (query, opts) => {
+      return paginate(
+        (cursor) => this.repo.search(query, { ...opts, cursor }),
+        (page) => page.items,
+        opts?.cursor
+      );
+    },
+    /**
+     * Materialize global repository search hits. Cursors resume the same query
+     * and result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the
+     * query without `cursor`.
+     */
+    searchAll: async (query, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages(
+        (cursor) => this.repo.search(query, { ...pageOpts, cursor }),
+        (page) => page.items,
+        max,
+        pageOpts.cursor
+      );
+    },
     /**
      * Create a repository inside an organization.
      *
@@ -10784,6 +10807,32 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Iterate repository rows with stats. Cursors resume the same query and
+     * result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query
+     * without `cursor`.
+     */
+    listPageIter: (orgName, opts) => {
+      return paginate(
+        (cursor) => this.repo.listPage(orgName, { ...opts, cursor }),
+        (page) => page.items,
+        opts?.cursor
+      );
+    },
+    /**
+     * Materialize repository rows with stats. Cursors resume the same query and
+     * result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query
+     * without `cursor`.
+     */
+    listPageAll: async (orgName, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages(
+        (cursor) => this.repo.listPage(orgName, { ...pageOpts, cursor }),
+        (page) => page.items,
+        max,
+        pageOpts.cursor
+      );
+    },
     /**
      * List the caller's repositories across every org they belong to, ordered
      * for recency by default (most recently written first), capped at `limit`.
@@ -10845,6 +10894,36 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Iterate public Explore browse results. Cursors resume the same query and
+     * result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query
+     * without `cursor`. Exact `slugs` lookup is not pageable.
+     */
+    exploreIter: (opts) => {
+      assertRepoExploreBrowseMode(opts);
+      return paginate(
+        (cursor) => this.repo.explore({ ...opts, cursor }),
+        (page) => page.items,
+        opts?.cursor
+      );
+    },
+    /**
+     * Materialize public Explore browse results. Cursors resume the same query
+     * and result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the
+     * query without `cursor`. Exact `slugs` lookup is not pageable. `max`
+     * remains optional as part of the uniform `*All` contract; callers should
+     * provide a finite cap for this offset-paginated endpoint.
+     */
+    exploreAll: async (opts) => {
+      assertRepoExploreBrowseMode(opts);
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages(
+        (cursor) => this.repo.explore({ ...pageOpts, cursor }),
+        (page) => page.items,
+        max,
+        pageOpts.cursor
+      );
+    },
     /**
      * Fetch a repository's `Content/Readme` markdown record.
      *
@@ -11142,6 +11221,32 @@ var WarmHubClient = class _WarmHubClient {
       } catch (error) {
         throw toWarmHubError(error);
       }
+    },
+    /**
+     * Iterate shape versions. Cursors resume the same query and result scope;
+     * on `VALIDATION_ERROR` / `Invalid cursor`, restart the query without
+     * `cursor`.
+     */
+    historyIter: (orgName, repoName, name, opts = {}) => {
+      return paginate(
+        (cursor) => this.shape.history(orgName, repoName, name, { ...opts, cursor }),
+        (page) => page.versions,
+        opts.cursor
+      );
+    },
+    /**
+     * Materialize shape versions. Cursors resume the same query and result
+     * scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query without
+     * `cursor`.
+     */
+    historyAll: async (orgName, repoName, name, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages(
+        (cursor) => this.shape.history(orgName, repoName, name, { ...pageOpts, cursor }),
+        (page) => page.versions,
+        max,
+        pageOpts.cursor
+      );
     }
   };
   /**
@@ -11423,6 +11528,38 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Iterate delivery-feed entries. Cursors resume the same query and result
+     * scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query without
+     * `cursor`.
+     */
+    liveFeedIter: (orgName, repoName, subscriptionName, opts) => {
+      return paginate(
+        (cursor) => this.action.liveFeed(orgName, repoName, subscriptionName, {
+          ...opts,
+          cursor
+        }),
+        (page) => page.items,
+        opts?.cursor
+      );
+    },
+    /**
+     * Materialize delivery-feed entries. Cursors resume the same query and
+     * result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query
+     * without `cursor`.
+     */
+    liveFeedAll: async (orgName, repoName, subscriptionName, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages(
+        (cursor) => this.action.liveFeed(orgName, repoName, subscriptionName, {
+          ...pageOpts,
+          cursor
+        }),
+        (page) => page.items,
+        max,
+        pageOpts.cursor
+      );
+    },
     /**
      * List subscription action runs as a `Page<ActionRunInfo>` (`items` +
      * optional `nextCursor`), newest-first, capped at 200 runs per page.
@@ -11430,8 +11567,9 @@ var WarmHubClient = class _WarmHubClient {
      * `status` and `outcome` are mutually exclusive.
      * `since` and `cursor` are mutually exclusive; pass `cursor` alone on later
      * pages — the `since` window rides in the cursor.
-     * Cursors are opaque, short-lived resume tokens; on `VALIDATION_ERROR`
-     * restart the query without `cursor`.
+     * Cursors are opaque, short-lived resume tokens for the same query and
+     * result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query
+     * without `cursor`.
      * See docs/dev/warmhub-actions-api.md for the full contract.
      */
     listRuns: async (orgName, repoName, opts) => {
@@ -11450,6 +11588,40 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Iterate action runs. Cursors resume the same query and result scope; on
+     * `VALIDATION_ERROR` / `Invalid cursor`, restart the query without `cursor`.
+     * `since` is sent only on the initial request.
+     */
+    listRunsIter: (orgName, repoName, opts) => {
+      return paginate(
+        (cursor) => this.action.listRuns(orgName, repoName, {
+          ...opts,
+          since: cursor === void 0 ? opts?.since : void 0,
+          cursor
+        }),
+        (page) => page.items,
+        opts?.cursor
+      );
+    },
+    /**
+     * Materialize action runs. Cursors resume the same query and result scope;
+     * on `VALIDATION_ERROR` / `Invalid cursor`, restart the query without
+     * `cursor`. `since` is sent only on the initial request.
+     */
+    listRunsAll: async (orgName, repoName, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages(
+        (cursor) => this.action.listRuns(orgName, repoName, {
+          ...pageOpts,
+          since: cursor === void 0 ? pageOpts.since : void 0,
+          cursor
+        }),
+        (page) => page.items,
+        max,
+        pageOpts.cursor
+      );
+    },
     /**
      * Return the newest visible action run for each subscription in a repo.
      *
@@ -11541,6 +11713,11 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Read one collection-membership page. Cursors resume the same query and
+     * result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query
+     * without `cursor`.
+     */
     members: async (orgName, repoName, wref, opts) => {
       try {
         return await this.trpc.collection.members.query({
@@ -11555,6 +11732,11 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Iterate collection members. Cursors resume the same query and result
+     * scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query without
+     * `cursor`.
+     */
     membersIter: (orgName, repoName, wref, opts) => {
       let snapshotVersion = opts?.version;
       return paginate(
@@ -11571,6 +11753,11 @@ var WarmHubClient = class _WarmHubClient {
         opts?.cursor
       );
     },
+    /**
+     * Materialize collection members. Cursors resume the same query and result
+     * scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query without
+     * `cursor`.
+     */
     membersAll: async (orgName, repoName, wref, opts) => {
       const { max, ...pageOpts } = opts ?? {};
       let snapshotVersion = pageOpts.version;
@@ -11708,7 +11895,8 @@ var WarmHubClient = class _WarmHubClient {
           componentRef: opts?.componentRef,
           excludeComponents: opts?.excludeComponents,
           excludeInfraShapes: opts?.excludeInfraShapes,
-          where: opts?.where
+          where: opts?.where,
+          sinceRepoSeq: opts?.sinceRepoSeq
         });
       } catch (error) {
         throw toWarmHubError(error);
@@ -11752,6 +11940,26 @@ var WarmHubClient = class _WarmHubClient {
         pageOpts.cursor
       );
     },
+    /**
+     * Materialize identity-owned changes after a repository sequence and return
+     * the exact checkpoint reached by the completed scan.
+     *
+     * Key a local cache by `item.metadata.durableId`: an identity rename
+     * carries its checkpoint wref, and a retraction carries `active: false`.
+     * This helper forces retracted rows on and returns only after draining the
+     * terminal page. It does not fan out changes caused by another identity
+     * and therefore is not, by itself, a complete local-result-mirror protocol.
+     */
+    headChanges: async (orgName, repoName, opts) => {
+      assertIncrementalLowerBound(opts?.sinceRepoSeq);
+      return await collectIncrementalPages(
+        (cursor) => this.thing.head(orgName, repoName, {
+          ...opts,
+          includeRetracted: true,
+          cursor
+        })
+      );
+    },
     /**
      * Get one thing, assertion, shape, or collection by wref.
      *
@@ -11985,6 +12193,32 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Iterate thing history versions. Cursors resume the same query and result
+     * scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query without
+     * `cursor`.
+     */
+    historyIter: (orgName, repoName, opts) => {
+      return paginate(
+        (cursor) => this.thing.history(orgName, repoName, { ...opts, cursor }),
+        (page) => page.versions,
+        opts.cursor
+      );
+    },
+    /**
+     * Materialize thing history versions. Cursors resume the same query and
+     * result scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query
+     * without `cursor`.
+     */
+    historyAll: async (orgName, repoName, opts) => {
+      const { max, ...pageOpts } = opts;
+      return await collectPaginatedPages(
+        (cursor) => this.thing.history(orgName, repoName, { ...pageOpts, cursor }),
+        (page) => page.versions,
+        max,
+        pageOpts.cursor
+      );
+    },
     /**
      * Rename a thing within its shape namespace.
      *
@@ -12127,7 +12361,8 @@ var WarmHubClient = class _WarmHubClient {
           componentRef: opts?.componentRef,
           excludeComponents: opts?.excludeComponents,
           excludeInfraShapes: opts?.excludeInfraShapes,
-          where: opts?.where
+          where: opts?.where,
+          sinceRepoSeq: opts?.sinceRepoSeq
         });
       } catch (error) {
         throw toWarmHubError(error);
@@ -12171,6 +12406,26 @@ var WarmHubClient = class _WarmHubClient {
         pageOpts.cursor
       );
     },
+    /**
+     * Materialize filtered identity-owned changes after a repository sequence
+     * and return the exact checkpoint reached by the completed scan.
+     *
+     * Key a local cache by `item.metadata.durableId`: an identity rename
+     * carries its checkpoint wref, and a retraction carries `active: false`.
+     * This helper forces retracted rows on and returns only after draining the
+     * terminal page. It does not fan out changes caused by another identity
+     * and therefore is not, by itself, a complete local-result-mirror protocol.
+     */
+    queryChanges: async (orgName, repoName, opts) => {
+      assertIncrementalLowerBound(opts?.sinceRepoSeq);
+      return await collectIncrementalPages(
+        (cursor) => this.thing.query(orgName, repoName, {
+          ...opts,
+          includeRetracted: true,
+          cursor
+        })
+      );
+    },
     /**
      * Search repository records with text, vector, or hybrid mode.
      *
@@ -12207,6 +12462,35 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Iterate ranked search hits. Cursors resume the same query and result
+     * scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query without
+     * `cursor`.
+     */
+    searchIter: (orgName, repoName, query, opts) => {
+      return paginate(
+        (cursor) => this.thing.search(orgName, repoName, query, { ...opts, cursor }),
+        (page) => page.items,
+        opts?.cursor
+      );
+    },
+    /**
+     * Materialize ranked search hits. Cursors resume the same query and result
+     * scope; on `VALIDATION_ERROR` / `Invalid cursor`, restart the query without
+     * `cursor`.
+     */
+    searchAll: async (orgName, repoName, query, opts) => {
+      const { max, ...pageOpts } = opts ?? {};
+      return await collectPaginatedPages(
+        (cursor) => this.thing.search(orgName, repoName, query, {
+          ...pageOpts,
+          cursor
+        }),
+        (page) => page.items,
+        max,
+        pageOpts.cursor
+      );
+    },
     /**
      * Count matching repository records without returning record data.
      */
@@ -12225,7 +12509,8 @@ var WarmHubClient = class _WarmHubClient {
           componentRef: opts?.componentRef,
           excludeComponents: opts?.excludeComponents,
           excludeInfraShapes: opts?.excludeInfraShapes,
-          where: opts?.where
+          where: opts?.where,
+          sinceRepoSeq: opts?.sinceRepoSeq
         });
       } catch (error) {
         throw toWarmHubError(error);
@@ -12987,5 +13272,5 @@ re2js/build/index.js:
 */
 
 export { AllStreamOperationsFailedError, CLI_INSTALL_REPO_HEADER, CLI_SIGNATURE_HEADER, CLI_TIMESTAMP_HEADER, CONTENT_FIELD_LIMIT_ERROR, CliCallVerificationError, DEFAULT_API_URL, DEFAULT_STREAM_CHUNK_SIZE, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT2 as MAX_STREAM_APPEND_OPERATION_COUNT, OperationBuilder, PartialStreamSubmissionError, SDK_VERSION, WarmHubClient, WarmHubError, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall };
-//# sourceMappingURL=chunk-PMLASUR6.js.map
-//# sourceMappingURL=chunk-PMLASUR6.js.map
+//# sourceMappingURL=chunk-6AHGGJL6.js.map
+//# sourceMappingURL=chunk-6AHGGJL6.js.map