@warmhub/sdk-ts 0.66.0 → 0.68.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.
@@ -72,7 +63,7 @@ type CliHttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
  *
  * Shape field types:
  * - "number", "string", "boolean": primitive types
- * - "wref": string (reference to another thing)
+ * - "wref": string (reference to a shape or shaped thing)
  * - Typed field objects: { type: primitive, description?: string }
  * - Nested objects: { fieldName: type, ... }
  * - Arrays: [elementType]
@@ -276,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;
@@ -312,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;
@@ -482,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';
@@ -502,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;
     } | {
@@ -544,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;
@@ -558,10 +616,7 @@ type StreamAppendInput$1 = {
     }>;
 };
 type StreamAppendResult$1 = {
-    allocatedTokenRanges: Array<{
-        start: number;
-        end: number;
-    }>;
+    allocatedTokenRanges: [];
     results: Array<{
         opIndex?: number;
         name: string;
@@ -712,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;
@@ -983,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.
      */
@@ -1039,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
@@ -1283,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.
@@ -1291,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`
@@ -1339,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
@@ -1500,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.
      */
@@ -1529,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 {
@@ -1544,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.
      */
@@ -1591,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
@@ -1826,8 +1901,6 @@ declare class OperationBuilder {
     private assertCanModify;
 }
 
-/** @internal */
-type CollectionAbout = CollectionAbout$1;
 /** @internal */
 type CollectionTag = CollectionTag$1;
 /** @internal */
@@ -1970,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
@@ -1978,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 & {});
@@ -2065,11 +2138,12 @@ type SubscriptionCompatCreateCommon = {
 };
 /**
  * Input shape for `client.subscription.create`, discriminated on `eventType`
- * (GH-4679):
+ * (GH-4679, GH-6553):
  *
  * - default / `commit` — operation-based, repo-scoped (`repoName`); requires a
  *   `filterJson` object and a shape binding (`shapeName` or `filterJson.shape`).
- * - `repo.renamed` — repo-scoped metadata event; no shape/filter/source.
+ * - `repo.renamed` / `thing.renamed` / `shape.renamed` — repo-scoped metadata
+ *   events; no shape/filter/source.
  * - `org.renamed` — org-scoped metadata event; no `repoName`/shape/filter/source.
  *
  * The metadata variants forbid the commit-only fields at the type level so
@@ -2084,7 +2158,7 @@ type SubscriptionCompatCreateInput = (SubscriptionCompatCreateCommon & {
     shapeName?: string;
     sourceRepoRef?: string;
 }) | (SubscriptionCompatCreateCommon & {
-    eventType: 'repo.renamed';
+    eventType: 'repo.renamed' | 'thing.renamed' | 'shape.renamed';
     repoName: string;
     filterJson?: never;
     shapeName?: never;
@@ -2100,7 +2174,7 @@ type SubscriptionCompatCreateInput = (SubscriptionCompatCreateCommon & {
  * Input shape for `client.subscription.update`. `orgName` and `name` identify
  * the subscription; omit `repoName` to update an org-scoped (`org.renamed`)
  * subscription. All other fields are optional and only the ones you provide get
- * patched. Rename subscriptions (`repo.renamed`/`org.renamed`) reject
+ * patched. Metadata subscriptions (any `*.renamed`) reject
  * `shapeName`/`filterJson` — they have only delivery fields to edit.
  *
  * @see https://docs.warmhub.ai/subscriptions/managing/#update-subscription
@@ -2580,6 +2654,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;
@@ -2645,6 +2733,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;
@@ -2792,6 +2881,7 @@ type ThingHistoryOptions = {
 /** @internal */
 type ThingGetOptions = {
     includeRetracted?: boolean;
+    dataMode?: CollectionReadDataMode;
 };
 /** @internal */
 type ThingGraphOptions = {
@@ -2889,6 +2979,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;
@@ -3026,6 +3130,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;
@@ -3435,7 +3594,7 @@ declare class WarmHubClient {
          *
          * @param message Optional commit message stored with the submitted operations.
          * @param operations Add, revise, or retract operations to submit in order.
-         * @param opts.committer Optional wref identifying the actor on whose behalf the write is made. Must be a full wref string like `"Agent/bot-1"` (a thing that already exists), or a cross-repo wref like `"wh:other-org/other-repo/Agent/bot-1"`. Bare names such as `"eval-runner"` are rejected by the backend with a "Thing wref required" error — there is no implicit shape.
+         * @param opts.committer Optional untyped wref identifying the actor on whose behalf the write is made. It may target an existing shape (`"Agent"`) or shaped thing (`"Agent/bot-1"`), locally or canonically (`"wh:other-org/other-repo/Agent"` or `"wh:other-org/other-repo/Agent/bot-1"`). A one-segment value is a shape wref, not a free-form label, and succeeds only when that shape exists. On success, `OperationSubmitResult.committer` echoes the supplied wref string; version reads expose the resolved target as `committerWref`.
          * @param opts.componentRef Attribute writes to an installed component, identified by its `Org/Name` ref, when the caller is allowed to claim it.
          * @param opts.chunkSize Maximum operations per stream append. Values are clamped by the SDK.
          * @param opts.skipExisting Return `noop` for add operations whose target already exists.
@@ -3985,6 +4144,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
@@ -4035,6 +4206,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>;
         /**
@@ -4085,6 +4257,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>;
@@ -4130,7 +4303,7 @@ declare class WarmHubClient {
          */
         resolve: (orgName: string | undefined, repoName: string | undefined, wref: string) => Promise<ResolveWrefResult>;
         /**
-         * Return assertions about a thing or collection target.
+         * Return assertions about a shape, shaped thing, or collection target.
          *
          * Filter by assertion shape or glob `match` pattern, optionally resolve collection targets, and page through large assertion sets with `limit` and `cursor`.
          *
@@ -4154,7 +4327,7 @@ declare class WarmHubClient {
          */
         about: (orgName: string | undefined, repoName: string | undefined, wref: string, opts?: AboutOptions) => Promise<AboutResult>;
         /**
-         * Iterate every assertion about a thing or collection target.
+         * Iterate every assertion about a shape, shaped thing, or collection target.
          *
          * Prefer this over hand-written cursor loops when scanning all matching assertions. The iterator reads the `assertions` envelope field and advances the cursor automatically; pass `opts.cursor` to resume from a saved cursor and `limit` to control page size.
          *
@@ -4166,7 +4339,7 @@ declare class WarmHubClient {
          */
         aboutIter: (orgName: string | undefined, repoName: string | undefined, wref: string, opts?: AboutOptions) => AsyncIterableIterator<Assertion>;
         /**
-         * Materialize every assertion about a thing or collection target.
+         * Materialize every assertion about a shape, shaped thing, or collection target.
          *
          * Use `max` to guard memory usage; throws a `WarmHubError` with kind `VALIDATION_ERROR` once more than `max` assertions have actually been observed across pages.
          *
@@ -4368,7 +4541,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>;
     };
@@ -4570,4 +4743,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 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 };
+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-U5Z6ZS6A.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-GNNCLRNC.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmhub/sdk-ts",
-  "version": "0.66.0",
+  "version": "0.68.0",
   "private": false,
   "type": "module",
   "description": "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",