@warmhub/sdk-ts 0.65.0 → 0.67.0

package/dist/index.d.ts

@@ -2,15 +2,6 @@ declare const COMMIT_OPERATIONS: readonly ["add", "revise", "retract", "rename"]
 type CommitOperation = (typeof COMMIT_OPERATIONS)[number];
 declare const COMMIT_OPERATION_KINDS: readonly ["shape", "thing", "assertion", "collection"];
 type CommitOperationKind = (typeof COMMIT_OPERATION_KINDS)[number];
-type CollectionAbout$2 = {
-    pair: [string, string];
-} | {
-    triple: [string, string, string];
-} | {
-    set: string[];
-} | {
-    list: string[];
-};
 
 /**
  * Canonical request signing for component CLI dispatch.
@@ -265,6 +256,7 @@ type AccessResolveResult$1 = {
         visible: boolean;
         scopes: Array<'repo:read' | 'repo:write' | 'repo:configure' | 'repo:admin' | 'repo:action-callback'>;
         allowedMatches?: Array<string>;
+        repoDurableId?: string;
     }>;
     orgs: Array<{
         orgName: string;
@@ -275,16 +267,7 @@ type AccessResolveResult$1 = {
 type AuthSyncResult = {
     success: boolean;
 };
-type CollectionAbout$1 = {
-    pair: [string, string];
-} | {
-    triple: [string, string, string];
-} | {
-    set: Array<string>;
-} | {
-    list: Array<string>;
-};
-type CollectionTag$1 = 'pair' | 'triple' | 'set' | 'list';
+type CollectionTag$1 = 'pair' | 'set' | 'list';
 type CommitApplyResult = {
     committer?: string;
     createdByEmail?: string;
@@ -311,6 +294,85 @@ type CommitApplyResult = {
         };
     }>;
 };
+type CollectionContainsResult$1 = {
+    type: 'pair' | 'set' | 'list' | 'triple';
+    wref: string;
+    version: number;
+    results: Array<{
+        member: string;
+        contains: boolean;
+        positions?: Array<number>;
+    }>;
+};
+type CollectionDiffResult$1 = {
+    type: 'pair' | 'set' | 'list' | 'triple';
+    leftWref: string;
+    rightWref: string;
+    leftVersion: number;
+    rightVersion: number;
+    mode: 'membership' | 'ordered';
+    added: Array<{
+        wref: string;
+        position?: number;
+        fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+    }>;
+    removed: Array<{
+        wref: string;
+        position?: number;
+        fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+    }>;
+    unchanged: Array<{
+        wref: string;
+        position?: number;
+        fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+    }>;
+    changed: Array<{
+        position: number;
+        left?: {
+            wref: string;
+            position?: number;
+            fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+        };
+        right?: {
+            wref: string;
+            position?: number;
+            fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+        };
+    }>;
+};
+type CollectionMember$1 = {
+    wref: string;
+    position?: number;
+    fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+};
+type CollectionMembersPage$1 = {
+    type: 'pair' | 'set' | 'list' | 'triple';
+    wref: string;
+    version: number;
+    items: Array<{
+        wref: string;
+        position?: number;
+        fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+    }>;
+    nextCursor?: string;
+};
+type CollectionMutationResult$1 = {
+    type: 'pair' | 'set' | 'list';
+    wref: string;
+    version: number;
+    memberCount: number;
+    dataHash?: string;
+    operationCount: number;
+    status: 'created' | 'updated' | 'noop';
+};
+type CollectionStatsResult$1 = {
+    type: 'pair' | 'set' | 'list' | 'triple';
+    wref: string;
+    version: number;
+    memberCount: number;
+    uniqueMemberCount: number;
+};
+type CollectionType$1 = 'pair' | 'set' | 'list';
 type ComponentDetail = {
     ref?: string;
     componentName: string;
@@ -481,10 +543,7 @@ type StreamAppendInput$1 = {
     committer?: string;
     message?: string;
     allocatedTokens?: never;
-    allocatedTokenRanges: Array<{
-        start: number;
-        end: number;
-    }>;
+    allocatedTokenRanges: [];
     operations: Array<{
         operation: 'add';
         kind: 'shape';
@@ -501,22 +560,14 @@ type StreamAppendInput$1 = {
         operation: 'add';
         kind: 'assertion';
         name: string;
-        about: string | {
-            pair: [string, string];
-        } | {
-            triple: [string, string, string];
-        } | {
-            set: Array<string>;
-        } | {
-            list: Array<string>;
-        };
+        about: string;
         data: unknown;
         skipExisting?: boolean;
     } | {
         operation: 'add';
         kind: 'collection';
-        name?: string;
-        type: 'pair' | 'triple' | 'set' | 'list';
+        name: string;
+        type: 'pair' | 'set' | 'list';
         members: Array<string>;
         skipExisting?: boolean;
     } | {
@@ -543,6 +594,14 @@ type StreamAppendInput$1 = {
         expectedVersion?: number;
         active?: never;
         leaseId?: string;
+    } | {
+        operation: 'revise';
+        kind: 'collection';
+        name: string;
+        type: 'pair' | 'set' | 'list';
+        members: Array<string>;
+        expectedVersion?: number;
+        leaseId?: string;
     } | {
         operation: 'retract';
         name: string;
@@ -557,10 +616,7 @@ type StreamAppendInput$1 = {
     }>;
 };
 type StreamAppendResult$1 = {
-    allocatedTokenRanges: Array<{
-        start: number;
-        end: number;
-    }>;
+    allocatedTokenRanges: [];
     results: Array<{
         opIndex?: number;
         name: string;
@@ -711,6 +767,17 @@ type ThingGetManyResult$1 = {
         validatedShape?: string;
         version: number;
         data?: unknown;
+        collection?: {
+            type: 'pair' | 'set' | 'list' | 'triple';
+            memberField: 'first/second' | 'first/second/third' | 'members' | 'items';
+            memberCount: number;
+            dataMode: 'full' | 'summary';
+            fullData: boolean;
+            truncated: boolean;
+            inlineLimit?: number;
+            preview?: Array<string>;
+            previewCount?: number;
+        };
         active: boolean;
         synthesized?: boolean;
         aboutWref?: string;
@@ -776,6 +843,48 @@ type RepoDescribeResult$1 = {
         synthesized: boolean;
     }>;
 };
+type RepoExploreInput = {
+    search?: string;
+    org?: string;
+    activity?: 'week' | 'month';
+    hasSubscriptions?: true;
+    minThings?: number;
+    sort?: 'recentlyUpdated' | 'mostSubscribed' | 'mostThings' | 'nameAsc' | 'newest';
+    limit?: number;
+    cursor?: string;
+    slugs?: Array<string>;
+};
+type RepoExploreItem$1 = {
+    orgName: string;
+    orgDisplayName?: string;
+    name: string;
+    displayName: string;
+    description?: string;
+    createdAt: number;
+    lastWriteAt?: number;
+    subscriptionCount: number;
+    thingCount: number;
+};
+type RepoExploreResult$1 = {
+    items: Array<{
+        orgName: string;
+        orgDisplayName?: string;
+        name: string;
+        displayName: string;
+        description?: string;
+        createdAt: number;
+        lastWriteAt?: number;
+        subscriptionCount: number;
+        thingCount: number;
+    }>;
+    nextCursor?: string;
+    total?: number;
+    orgs?: Array<{
+        name: string;
+        displayName?: string;
+        count: number;
+    }>;
+};
 type RepoForCaller = {
     orgName: string;
     name: string;
@@ -940,10 +1049,10 @@ interface AddOperation {
      */
     name?: string;
     /**
-     * Assertion target wref or inline collection descriptor. Presence of
+     * Assertion target wref. Presence of
      * `about` makes the add an assertion unless `kind` overrides it.
      */
-    about?: string | CollectionAbout$1;
+    about?: string;
     /**
      * Shape-validated data payload for shape, thing, or assertion adds.
      */
@@ -996,6 +1105,14 @@ interface ReviseOperation {
      * New shape-validated data payload.
      */
     data?: unknown;
+    /**
+     * Collection type. Required when `kind` is `collection`.
+     */
+    type?: CollectionTag$1;
+    /**
+     * Collection member wrefs. Required when `kind` is `collection`.
+     */
+    members?: string[];
     /**
      * Optional optimistic-concurrency precondition. When supplied, the revise is
      * applied only if the target is still at this version number. A stale value
@@ -1240,7 +1357,7 @@ declare class AllStreamOperationsFailedError extends Error {
  * transport-ambiguous failure (timeout / 5xx / network reset / no-code
  * error) on the first chunk triggers a bounded retry — but only when
  * the first chunk contains exactly one operation. The SDK mints a
- * fresh `streamId`, resets token continuation, sleeps with jittered
+ * fresh `streamId`, sleeps with jittered
  * exponential backoff, and re-issues the same operation. The retried
  * call is observationally indistinguishable from a single clean
  * apply — the SDK does not rewrite the request or the response.
@@ -1248,17 +1365,13 @@ declare class AllStreamOperationsFailedError extends Error {
  * Multi-op chunks bypass retry entirely because the backend applies
  * operations one-at-a-time in their own transactions, so a mid-chunk
  * transport failure on attempt 1 may have committed an arbitrary
- * prefix. Chunks that allocate or reference `$N`/`#N` tokens also
- * bypass retry — the backend resolves those tokens against `streamId`,
- * so re-issuing under a fresh `streamId` would commit a different
- * identity than the first attempt may have landed. Multi-chunk
- * mid-flight failures (`chunkResults.length > 0`) also bypass retry.
- * All three surface `PartialStreamSubmissionError` exactly as before;
+ * prefix. Multi-chunk mid-flight failures (`chunkResults.length > 0`)
+ * also bypass retry. Both surface `PartialStreamSubmissionError` exactly as before;
  * the existing full-input rerun contract remains the recovery path.
  *
  * Definite client rejections (`UNAUTHENTICATED`, `VALIDATION_ERROR`,
- * `CONFLICT`, `RATE_LIMITED`, `UNRESOLVED_TOKEN`, `ALREADY_RETRACTED`,
- * …) on the first chunk still rethrow the raw cause unchanged — they
+ * `CONFLICT`, `RATE_LIMITED`, `ALREADY_RETRACTED`, …) on the first chunk
+ * still rethrow the raw cause unchanged — they
  * are not transient, and structured detail (e.g. `retryAfter` on
  * `RATE_LIMITED`) survives. If the caller's original attempt landed but
  * the response was lost, the retry surfaces the resulting `CONFLICT`
@@ -1296,10 +1409,8 @@ declare class AllStreamOperationsFailedError extends Error {
  * any subset of the defaults (`{ 3, 250, 8_000 }`).
  *
  * Retry is automatically suppressed when the caller supplies
- * `args.streamId`. Re-minting a fresh `streamId` on retry would
- * invalidate deterministic `$N`/`#N` token bindings, so caller-managed
- * streams instead surface `PartialStreamSubmissionError` on append
- * failure.
+ * `args.streamId`, because caller-managed streams may coordinate retries
+ * outside the SDK.
  *
  * The server remains stateless across `stream.append` calls — there is
  * no `streamId`-keyed dedup table. See docs/dev/commit-flow.md for the
@@ -1457,7 +1568,7 @@ interface BaseAddOp {
     /**
      * Assertion target wref. Presence of `about` makes the add an assertion unless `kind` overrides it.
      */
-    readonly about?: string | CollectionAbout$2;
+    readonly about?: string;
     /**
      * Optional shape wref used by local validation.
      */
@@ -1486,8 +1597,7 @@ interface AddOp extends BaseAddOp {
     readonly name: string;
 }
 /**
- * Builder collection add operation. Omitting `name` creates the backend's
- * canonical auto-named collection from the supplied members.
+ * Builder collection add operation. ADR 0004 requires an explicit name.
  * @see https://docs.warmhub.ai/sdk-reference/interfaces/collectionaddop/
  */
 interface CollectionAddOp {
@@ -1501,10 +1611,10 @@ interface CollectionAddOp {
      */
     readonly kind?: 'collection';
     /**
-     * Optional collection name. Omit to let the backend assign the canonical
-     * collection name from the supplied members.
+     * Explicit collection name. ADR 0004 treats collections as ordinary named
+     * things, so collection adds cannot be nameless.
      */
-    readonly name?: string;
+    readonly name: string;
     /**
      * Collection type.
      */
@@ -1548,6 +1658,14 @@ interface ReviseOp {
      * New shape-validated data payload.
      */
     readonly data?: unknown;
+    /**
+     * Collection type. Required when `kind` is `collection`.
+     */
+    readonly type?: CollectionAddType;
+    /**
+     * Collection member wrefs. Required when `kind` is `collection`.
+     */
+    readonly members?: string[];
     /**
      * Optional optimistic-concurrency precondition. When supplied, the revise is
      * applied only if the target is still at this version number. A stale value
@@ -1783,8 +1901,6 @@ declare class OperationBuilder {
     private assertCanModify;
 }
 
-/** @internal */
-type CollectionAbout = CollectionAbout$1;
 /** @internal */
 type CollectionTag = CollectionTag$1;
 /** @internal */
@@ -1927,7 +2043,7 @@ type CoreErrorKind = 'BACKEND' | 'NOT_FOUND' | 'FORBIDDEN' | 'UNAUTHENTICATED' |
  * - `NETWORK` — cause: connection failed before the server produced a response (DNS, refused, timeout, fetch error); retryable: true; action: check connectivity to the configured `apiUrl` and retry with backoff; origin: SDK `fetchWithAuth` connection-error mapping
  *
  * Backend domain codes (e.g. `SHAPE_MISMATCH`, `WREF_UNRESOLVABLE`,
- * `UNRESOLVED_TOKEN`, `ARCHIVED`, `INTERNAL_ERROR`) pass through unchanged on
+ * `ARCHIVED`, `INTERNAL_ERROR`) pass through unchanged on
  * `code` / `kind`. Surface the `message` and `hint` verbatim and use the
  * message to decide whether to retry — most pass-through codes are terminal,
  * but the backend reuses some codes for transient failures (notably
@@ -1935,8 +2051,8 @@ type CoreErrorKind = 'BACKEND' | 'NOT_FOUND' | 'FORBIDDEN' | 'UNAUTHENTICATED' |
  * `please retry` message when DNS or HEAD probes flake). See the
  * [HTTP error catalog](/http-api/overview/#response-format)
  * for HTTP-status mapping and the most common backend codes (the catalog is
- * not exhaustive — rarer codes such as `UNRESOLVED_TOKEN` and
- * `WREF_UNRESOLVABLE` are emitted by the backend but not yet tabulated).
+ * not exhaustive — rarer codes such as `WREF_UNRESOLVABLE` are emitted by the
+ * backend but not yet tabulated).
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/errorkind/
  */
 type ErrorKind = CoreErrorKind | (string & {});
@@ -2400,6 +2516,43 @@ type RepoListForCallerOptions = {
     limit?: number;
     sort?: 'recent' | 'name';
 };
+/**
+ * Options for the public "Explore" directory (`client.repo.explore`).
+ *
+ * Structural alias of the generated `RepoExploreInput` (sourced from the
+ * backend `repoExploreInputSchema` via the backend-types pipeline), so it
+ * can't drift from the procedure's input contract.
+ *
+ * Two mutually-exclusive modes: the browse mode
+ * (`search`/`org`/`activity`/`hasSubscriptions`/`minThings`/`sort`/`limit`/`cursor`)
+ * and the exact-match `slugs` batch lookup. `slugs` cannot be combined with any
+ * browse/search/sort/filter field — the backend rejects the mix.
+ *
+ * @internal
+ */
+type RepoExploreOptions = RepoExploreInput;
+/**
+ * A repository row in the public "Explore" directory
+ * (`client.repo.explore`).
+ *
+ * Structural alias of the generated `RepoExploreItem` (sourced from the backend
+ * `repoExploreItemSchema` via the backend-types pipeline), so it can't drift.
+ *
+ * @internal
+ */
+type RepoExploreItem = RepoExploreItem$1;
+/**
+ * Result of the public "Explore" directory (`client.repo.explore`).
+ *
+ * `total` and `orgs` are first-page only (present when `cursor` is absent).
+ *
+ * Structural alias of the generated `RepoExploreResult` (sourced from the
+ * backend `repoExploreResultSchema` via the backend-types pipeline), so it
+ * can't drift.
+ *
+ * @internal
+ */
+type RepoExploreResult = RepoExploreResult$1;
 /** @internal */
 type CurrentUserInfo = {
     id: string;
@@ -2500,6 +2653,20 @@ type ThingMetadata = {
     revisedOn: number;
 };
 /** @internal */
+type CollectionReadDataMode = 'auto' | 'full';
+/** @internal */
+type CollectionReadSummary = {
+    type: 'pair' | 'set' | 'list' | 'triple';
+    memberField: 'first/second' | 'first/second/third' | 'members' | 'items';
+    memberCount: number;
+    dataMode: 'full' | 'summary';
+    fullData: boolean;
+    truncated: boolean;
+    inlineLimit?: number;
+    preview?: string[];
+    previewCount?: number;
+};
+/** @internal */
 type ThingItem = {
     wref: string;
     name: string;
@@ -2565,6 +2732,7 @@ type ThingDetail = {
     version: number;
     active: boolean;
     data?: unknown;
+    collection?: CollectionReadSummary;
     /** True on synthesized empty stubs from getReadme/getAgents when no row exists yet. */
     synthesized?: boolean;
     aboutWref?: string;
@@ -2712,6 +2880,7 @@ type ThingHistoryOptions = {
 /** @internal */
 type ThingGetOptions = {
     includeRetracted?: boolean;
+    dataMode?: CollectionReadDataMode;
 };
 /** @internal */
 type ThingGraphOptions = {
@@ -2809,6 +2978,20 @@ type SearchResult = HeadResult;
 /** @internal */
 type RefsResult = RefsResult$1;
 /** @internal */
+type CollectionType = CollectionType$1;
+/** @internal */
+type CollectionMember = CollectionMember$1;
+/** @internal */
+type CollectionMembersPage = CollectionMembersPage$1;
+/** @internal */
+type CollectionContainsResult = CollectionContainsResult$1;
+/** @internal */
+type CollectionDiffResult = CollectionDiffResult$1;
+/** @internal */
+type CollectionMutationResult = CollectionMutationResult$1;
+/** @internal */
+type CollectionStatsResult = CollectionStatsResult$1;
+/** @internal */
 type ResolveWrefResult = ThingDetail;
 /** @internal */
 type ThingGetManyResult = ThingGetManyResult$1;
@@ -2917,6 +3100,8 @@ type SearchOptions = Omit<FilterOptions, 'where'> & {
     about?: string;
     /** Search mode: `text` (BM25), `vector` (semantic), or `hybrid` (combined). Defaults to `text`. */
     mode?: 'text' | 'vector' | 'hybrid';
+    /** Opt into deterministic literal name matching before ranked search. Intended for UI list filtering; defaults to ranked search. */
+    nameMatch?: 'ranked' | 'deterministic';
     /** Expand collection members in the result; pages may be sparse when set. */
     resolveCollections?: boolean;
     /** Exclude internal infrastructure shapes from results. */
@@ -2944,6 +3129,61 @@ type RefsOptions = {
     cursor?: string;
 };
 /** @internal */
+type CollectionQuerySourceOptions = Pick<FilterOptions, 'shape' | 'kind' | 'about' | 'match' | 'componentRef' | 'excludeComponents' | 'where'>;
+type CollectionMemberSourceOptions = {
+    members: string[];
+    query?: CollectionQuerySourceOptions;
+    sourceRepo?: never;
+} | {
+    members?: never;
+    query: CollectionQuerySourceOptions;
+    sourceRepo: RepoLocator;
+} | {
+    members?: string[];
+    query: CollectionQuerySourceOptions;
+    sourceRepo?: never;
+};
+/** @internal */
+type CollectionCreateOptions = {
+    type: CollectionType;
+    name: string;
+    from?: string;
+    add?: string[];
+    remove?: string[];
+    replaceMembers?: string[];
+    skipExisting?: boolean;
+    message?: string;
+    committer?: string;
+} & CollectionMemberSourceOptions;
+/** @internal */
+type CollectionMembersOptions = {
+    version?: number;
+    limit?: number;
+    cursor?: string;
+};
+/** @internal */
+type CollectionContainsOptions = {
+    version?: number;
+    position?: number;
+};
+/** @internal */
+type CollectionDiffOptions = {
+    leftVersion?: number;
+    rightVersion?: number;
+    mode?: 'auto' | 'membership' | 'ordered';
+};
+/** @internal */
+type CollectionReviseOptions = {
+    add?: string[];
+    remove?: string[];
+    message?: string;
+    committer?: string;
+} & CollectionMemberSourceOptions;
+/** @internal */
+type CollectionStatsOptions = {
+    version?: number;
+};
+/** @internal */
 type PingResult = {
     ok: boolean;
     error?: string;
@@ -3614,6 +3854,30 @@ declare class WarmHubClient {
          * the org-scoped `listPage` from token-authenticated contexts.
          */
         listForCaller: (opts?: RepoListForCallerOptions) => Promise<RepoRecentInfo[]>;
+        /**
+         * Browse the public "Explore" directory: every `visibility='public'` live
+         * repository across all orgs, with search, org/activity/subscription/thing
+         * filters, and sort. No auth required — anonymous callers see the same
+         * public-only listing.
+         *
+         * Two mutually-exclusive modes. Browse mode paginates a filtered, sorted
+         * listing (`search`/`org`/`activity`/`hasSubscriptions`/`minThings`/`sort`/
+         * `limit`/`cursor`). Slugs mode is an exact-match batch lookup: pass up to
+         * 12 `org/repo` slugs to resolve just those live public repos in input
+         * order, ignoring every browse field. Combining `slugs` with any browse/
+         * search/sort/filter field is a hard input error, not a silently-filtered
+         * list.
+         *
+         * `total` and `orgs` (the org-filter facet) are returned on the first page
+         * only — i.e. when `cursor` is absent.
+         *
+         * Cursor contract: cursors are short-lived resume tokens for the same query
+         * and result scope. If filters, visibility, or backing streams change, the
+         * backend may reject a saved cursor with `VALIDATION_ERROR` / `Invalid
+         * cursor`; restart the query without `cursor` instead of retrying the stale
+         * token.
+         */
+        explore: (opts?: RepoExploreOptions) => Promise<RepoExploreResult>;
         /**
          * Fetch a repository's `Content/Readme` markdown record.
          *
@@ -3879,6 +4143,18 @@ declare class WarmHubClient {
          */
         listNotifications: (orgName: string, repoName: string, opts?: ActionListNotificationsOptions) => Promise<ActionNotificationInfo[]>;
     };
+    readonly collection: {
+        create: (orgName: string, repoName: string, opts: CollectionCreateOptions) => Promise<CollectionMutationResult>;
+        members: (orgName: string | undefined, repoName: string | undefined, wref: string, opts?: CollectionMembersOptions) => Promise<CollectionMembersPage>;
+        membersIter: (orgName: string | undefined, repoName: string | undefined, wref: string, opts?: CollectionMembersOptions) => AsyncIterableIterator<CollectionMember>;
+        membersAll: (orgName: string | undefined, repoName: string | undefined, wref: string, opts?: CollectionMembersOptions & {
+            max?: number;
+        }) => Promise<CollectionMember[]>;
+        contains: (orgName: string | undefined, repoName: string | undefined, wref: string, members: string[], opts?: CollectionContainsOptions) => Promise<CollectionContainsResult>;
+        diff: (orgName: string | undefined, repoName: string | undefined, leftWref: string, rightWref: string, opts?: CollectionDiffOptions) => Promise<CollectionDiffResult>;
+        revise: (orgName: string, repoName: string, wref: string, opts: CollectionReviseOptions) => Promise<CollectionMutationResult>;
+        stats: (orgName: string | undefined, repoName: string | undefined, wref: string, opts?: CollectionStatsOptions) => Promise<CollectionStatsResult>;
+    };
     /**
      * Read surface for things, assertions, histories, references, search, and in-place thing renames.
      * @see https://docs.warmhub.ai/sdk-reference/classes/warmhubclient/#thing
@@ -3929,6 +4205,7 @@ declare class WarmHubClient {
          *
          * @param version Optional exact version to pin when the wref is not already version-qualified.
          * @param opts.includeRetracted Include retracted records instead of treating them as missing.
+         * @param opts.dataMode Defaults to `auto`; pass `full` to force full collection bodies.
          */
         get: (orgName: string | undefined, repoName: string | undefined, wref: string, version?: number, opts?: ThingGetOptions) => Promise<ThingGet>;
         /**
@@ -3979,6 +4256,7 @@ declare class WarmHubClient {
          */
         getMany: (orgName: string | undefined, repoName: string | undefined, wrefs: string[], version?: number, opts?: {
             includeRetracted?: boolean;
+            dataMode?: CollectionReadDataMode;
             chunkSize?: number;
             chunkConcurrency?: number;
         }) => Promise<ThingGetManyResult>;
@@ -4262,7 +4540,7 @@ declare class WarmHubClient {
         /**
          * Append one non-empty chunk of stream operations to a repository.
          *
-         * Most callers should prefer `commit.apply` or `OperationBuilder`. Use this low-level surface only when you already have stream operations, a stream ID, and any allocated `$N` / `#N` token state you need to continue.
+         * Most callers should prefer `commit.apply` or `OperationBuilder`. Use this low-level surface only when you already have backend-shaped stream operations and a caller-managed stream ID.
          */
         append: (input: StreamAppendInput$1) => Promise<StreamAppendResult$1>;
     };
@@ -4464,4 +4742,4 @@ declare class WarmHubClient {
     private watchRepoQuery;
 }
 
-export { type AboutOptions, type AboutResult, type AccessResolveInput, type AccessResolveResult, type AccessTokenProvider, type ActionAttemptInfo, type ActionDeliveryTarget, type ActionLeaseAcquire, type ActionLeaseOp, type ActionListNotificationsOptions, type ActionListRunsOptions, type ActionLiveFeed, type ActionLiveFeedOptions, type ActionNotificationInfo, type ActionRunInfo, type ActionRunStatsInfo, type ActionRunStatsOptions, type AddOp, type AddOperation, AllStreamOperationsFailedError, type Assertion, CLI_INSTALL_REPO_HEADER, CLI_SIGNATURE_HEADER, CLI_TIMESTAMP_HEADER, CONTENT_FIELD_LIMIT_ERROR, type CliCallSecrets, CliCallVerificationError, type CliCallVerificationFailureReason, type CollectionAbout, type CollectionAddOp, type CollectionAddType, type CollectionTag, type ComponentHistory, type ComponentHistoryOptions, type ComponentInfo, type ComponentInstallResult, type ComponentList, type ComponentListOptions, type ComponentUninstallResult, type ComponentView, type CoreErrorKind, type CountOptions, type CountResult, type CredentialAuditEntry, type CredentialDeleteResult, type CredentialGrantResult, type CredentialInfo, type CredentialKeyMutationResult, type CredentialRevokeResult, type CredentialUngrantResult, type CurrentUserInfo, DEFAULT_API_URL, DEFAULT_STREAM_CHUNK_SIZE, type ErrorKind, type FilterOptions, type FilterResult, type FunctionLogMode, type GlobalSearchOptions, type GlobalSearchResult, type GlobalSearchResultItem, type HeadResult, type HistoryResult, type HomepageFeaturedListsResult, type IndexedFieldEntry, type IndexedFieldsReport, type LiveHandle, type LiveRepoEvent, type LiveSubscriptionLogOptions, type LiveThingHeadOptions, type LiveThingHistoryOptions, type LiveWatchResult, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT, type Operation, OperationBuilder, type OperationBuilderAddInput, type OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationSubmitResult, type OrgAccessResult, type OrgInfo, type OrgList, type OrgListMembersOptions, type OrgListOptions, type OrgMemberInfo, type OrgMemberList, type OrgRef, type OrgRole, type Page, type PageRequest, PartialStreamSubmissionError, type PingResult, type RefLink, type RefsOptions, type RefsResult, type RenameOperation, type RenameResult, type RepoAccessResult, type RepoConfigureStatsView, type RepoDescribeResult, type RepoInfo, type RepoList, type RepoListForCallerOptions, type RepoListOptions, type RepoListPageOptions, type RepoListPageResult, type RepoLocator, type RepoRecentInfo, type RepoRef, type RepoShapeInstanceCountsView, type RepoSort, type RepoStatsBatchResult, type RepoStatsView, type RepoWithStatsInfo, type RequestEvent, type ResolveWrefResult, type RetractOp, type RetractOperation, type RetryPolicyOptions, type ReviseOp, type ReviseOperation, SDK_VERSION, type SearchOptions, type SearchResult, type Shape, type ShapeChange, type ShapeCreateOptions, type ShapeFields, type ShapeGetOptions, type ShapeHistory, type ShapeHistoryOptions, type ShapeList, type ShapeListOptions, type ShapeRef, type ShapeRemove, type ShapeReviseOptions, type ShapeValidatorResult, type StreamAppendInput, type StreamAppendResult, type StreamContinuationState, type SubscriptionBindCredentialsResult, type SubscriptionCompatCreateInput, type SubscriptionCompatUpdateInput, type SubscriptionInfo, type SubscriptionList, type SubscriptionUnbindCredentialsResult, type SynthesizedRepoContent, type ThingDetail, type ThingGet, type ThingGetManyResult, type ThingGetOptions, type ThingGetWithLease, type ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadOptions, type ThingHeadRequest, type ThingHeadVersionsResult, type ThingHistory, type ThingHistoryOptions, type ThingItem, type ThingMetadata, type TokenInfo, type TokenResult, type UndeclaredFieldsWarning, type ValidationDiagnostic, type ValidationResult, type VerifiedCliCall, WarmHubClient, type WarmHubClientOptions, WarmHubError, type WarmHubErrorDetails, type WherePredicate, type WhoamiInfo, type WhoamiScopeEntry, type WireScopeEntry, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall };
+export { type AboutOptions, type AboutResult, type AccessResolveInput, type AccessResolveResult, type AccessTokenProvider, type ActionAttemptInfo, type ActionDeliveryTarget, type ActionLeaseAcquire, type ActionLeaseOp, type ActionListNotificationsOptions, type ActionListRunsOptions, type ActionLiveFeed, type ActionLiveFeedOptions, type ActionNotificationInfo, type ActionRunInfo, type ActionRunStatsInfo, type ActionRunStatsOptions, type AddOp, type AddOperation, AllStreamOperationsFailedError, type Assertion, CLI_INSTALL_REPO_HEADER, CLI_SIGNATURE_HEADER, CLI_TIMESTAMP_HEADER, CONTENT_FIELD_LIMIT_ERROR, type CliCallSecrets, CliCallVerificationError, type CliCallVerificationFailureReason, type CollectionAddOp, type CollectionAddType, type CollectionContainsOptions, type CollectionContainsResult, type CollectionCreateOptions, type CollectionDiffOptions, type CollectionDiffResult, type CollectionMember, type CollectionMembersOptions, type CollectionMembersPage, type CollectionMutationResult, type CollectionQuerySourceOptions, type CollectionReadDataMode, type CollectionReadSummary, type CollectionReviseOptions, type CollectionStatsOptions, type CollectionStatsResult, type CollectionTag, type CollectionType, type ComponentHistory, type ComponentHistoryOptions, type ComponentInfo, type ComponentInstallResult, type ComponentList, type ComponentListOptions, type ComponentUninstallResult, type ComponentView, type CoreErrorKind, type CountOptions, type CountResult, type CredentialAuditEntry, type CredentialDeleteResult, type CredentialGrantResult, type CredentialInfo, type CredentialKeyMutationResult, type CredentialRevokeResult, type CredentialUngrantResult, type CurrentUserInfo, DEFAULT_API_URL, DEFAULT_STREAM_CHUNK_SIZE, type ErrorKind, type FilterOptions, type FilterResult, type FunctionLogMode, type GlobalSearchOptions, type GlobalSearchResult, type GlobalSearchResultItem, type HeadResult, type HistoryResult, type HomepageFeaturedListsResult, type IndexedFieldEntry, type IndexedFieldsReport, type LiveHandle, type LiveRepoEvent, type LiveSubscriptionLogOptions, type LiveThingHeadOptions, type LiveThingHistoryOptions, type LiveWatchResult, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT, type Operation, OperationBuilder, type OperationBuilderAddInput, type OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationSubmitResult, type OrgAccessResult, type OrgInfo, type OrgList, type OrgListMembersOptions, type OrgListOptions, type OrgMemberInfo, type OrgMemberList, type OrgRef, type OrgRole, type Page, type PageRequest, PartialStreamSubmissionError, type PingResult, type RefLink, type RefsOptions, type RefsResult, type RenameOperation, type RenameResult, type RepoAccessResult, type RepoConfigureStatsView, type RepoDescribeResult, type RepoExploreItem, type RepoExploreOptions, type RepoExploreResult, type RepoInfo, type RepoList, type RepoListForCallerOptions, type RepoListOptions, type RepoListPageOptions, type RepoListPageResult, type RepoLocator, type RepoRecentInfo, type RepoRef, type RepoShapeInstanceCountsView, type RepoSort, type RepoStatsBatchResult, type RepoStatsView, type RepoWithStatsInfo, type RequestEvent, type ResolveWrefResult, type RetractOp, type RetractOperation, type RetryPolicyOptions, type ReviseOp, type ReviseOperation, SDK_VERSION, type SearchOptions, type SearchResult, type Shape, type ShapeChange, type ShapeCreateOptions, type ShapeFields, type ShapeGetOptions, type ShapeHistory, type ShapeHistoryOptions, type ShapeList, type ShapeListOptions, type ShapeRef, type ShapeRemove, type ShapeReviseOptions, type ShapeValidatorResult, type StreamAppendInput, type StreamAppendResult, type StreamContinuationState, type SubscriptionBindCredentialsResult, type SubscriptionCompatCreateInput, type SubscriptionCompatUpdateInput, type SubscriptionInfo, type SubscriptionList, type SubscriptionUnbindCredentialsResult, type SynthesizedRepoContent, type ThingDetail, type ThingGet, type ThingGetManyResult, type ThingGetOptions, type ThingGetWithLease, type ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadOptions, type ThingHeadRequest, type ThingHeadVersionsResult, type ThingHistory, type ThingHistoryOptions, type ThingItem, type ThingMetadata, type TokenInfo, type TokenResult, type UndeclaredFieldsWarning, type ValidationDiagnostic, type ValidationResult, type VerifiedCliCall, WarmHubClient, type WarmHubClientOptions, WarmHubError, type WarmHubErrorDetails, type WherePredicate, type WhoamiInfo, type WhoamiScopeEntry, type WireScopeEntry, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall };

package/dist/index.js

@@ -1,3 +1,3 @@
-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_COUNT, OperationBuilder, PartialStreamSubmissionError, SDK_VERSION, WarmHubClient, WarmHubError, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall } from './chunk-C2Q4D3JM.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_COUNT, OperationBuilder, PartialStreamSubmissionError, SDK_VERSION, WarmHubClient, WarmHubError, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall } from './chunk-2KN2JWJU.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react.js

@@ -1,5 +1,5 @@
-import { WarmHubClient } from './chunk-C2Q4D3JM.js';
-export { DEFAULT_API_URL, SDK_VERSION, WarmHubClient, WarmHubError, toWarmHubError } from './chunk-C2Q4D3JM.js';
+import { WarmHubClient } from './chunk-2KN2JWJU.js';
+export { DEFAULT_API_URL, SDK_VERSION, WarmHubClient, WarmHubError, toWarmHubError } from './chunk-2KN2JWJU.js';
 import { createContext, useMemo, useState, useEffect, useContext } from 'react';
 import { jsx } from 'react/jsx-runtime';