@warmhub/sdk-ts 0.73.0 → 0.74.0

package/dist/index.d.ts

@@ -279,12 +279,13 @@ type AccessResolveResult$1 = {
 type AuthSyncResult = {
     success: boolean;
 };
-type CollectionTag$1 = 'pair' | 'set' | 'list';
+type CollectionTag$1 = 'arc' | 'bond' | 'pair' | 'set' | 'list';
 type CommitApplyResult = {
     committer?: string;
     createdByEmail?: string;
     message?: string;
     operationCount: number;
+    repoSeq?: number;
     operations: Array<{
         opIndex?: number;
         name: string;
@@ -303,6 +304,11 @@ type CommitApplyResult = {
             }>;
             coalescedWrefsTruncated?: true;
             totalCoalescedWrefs?: number;
+            deprecations?: Array<{
+                shape: string;
+                message: string;
+                removalMilestone: string;
+            }>;
         };
     }>;
 };
@@ -369,13 +375,30 @@ type CollectionMembersPage$1 = {
     nextCursor?: string;
 };
 type CollectionMutationResult$1 = {
-    type: 'pair' | 'set' | 'list';
+    type: 'arc' | 'bond' | 'set' | 'list' | 'pair';
     wref: string;
     version: number;
     memberCount: number;
     dataHash?: string;
     operationCount: number;
     status: 'created' | 'updated' | 'noop';
+    warnings?: {
+        undeclaredFields?: Array<string>;
+        undeclaredFieldsTruncated?: true;
+        totalUndeclared?: number;
+        coalescedWrefs?: Array<{
+            fieldPath: string;
+            wref: string;
+            reason: string;
+        }>;
+        coalescedWrefsTruncated?: true;
+        totalCoalescedWrefs?: number;
+        deprecations?: Array<{
+            shape: string;
+            message: string;
+            removalMilestone: string;
+        }>;
+    };
 };
 type CollectionStatsResult$1 = {
     type: 'arc' | 'bond' | 'pair' | 'set' | 'list' | 'triple';
@@ -384,7 +407,7 @@ type CollectionStatsResult$1 = {
     memberCount: number;
     uniqueMemberCount: number;
 };
-type CollectionType$1 = 'pair' | 'set' | 'list';
+type CollectionType$1 = 'arc' | 'bond' | 'set' | 'list' | 'pair';
 type ComponentDetail = {
     ref?: string;
     componentName: string;
@@ -424,6 +447,7 @@ type ComponentDetail = {
         data?: unknown;
         active: boolean;
         aboutWref?: string;
+        roles?: Array<'from' | 'to' | 'ends' | 'first' | 'second'>;
         metadata?: {
             durableId: string;
             createdOn: number;
@@ -554,6 +578,7 @@ type StreamAppendInput$1 = {
     workspaceName?: never;
     committer?: string;
     message?: string;
+    returnRepoSeq?: boolean;
     allocatedTokens?: never;
     allocatedTokenRanges: [];
     operations: Array<{
@@ -579,7 +604,7 @@ type StreamAppendInput$1 = {
         operation: 'add';
         kind: 'collection';
         name: string;
-        type: 'pair' | 'set' | 'list';
+        type: 'arc' | 'bond' | 'pair' | 'set' | 'list';
         members: Array<string>;
         skipExisting?: boolean;
     } | {
@@ -610,7 +635,7 @@ type StreamAppendInput$1 = {
         operation: 'revise';
         kind: 'collection';
         name: string;
-        type: 'pair' | 'set' | 'list';
+        type: 'arc' | 'bond' | 'pair' | 'set' | 'list';
         members: Array<string>;
         expectedVersion?: number;
         leaseId?: string;
@@ -656,6 +681,10 @@ type StreamAppendResult$1 = {
                 reason: 'rate_limit_reset';
                 retryAfterSeconds: number;
                 resetAt: string;
+            } | {
+                reason: 'cursor_fence_unavailable';
+                cause: 'not_ready' | 'below_floor' | 'above_head';
+                retryFromStart: true;
             };
         };
         resolvedName?: string;
@@ -671,8 +700,14 @@ type StreamAppendResult$1 = {
             }>;
             coalescedWrefsTruncated?: true;
             totalCoalescedWrefs?: number;
+            deprecations?: Array<{
+                shape: string;
+                message: string;
+                removalMilestone: string;
+            }>;
         };
     }>;
+    repoSeq?: number;
     createdByEmail?: string;
     appendTotalMs?: number;
     appendResolveRepoMs?: number;
@@ -731,6 +766,7 @@ type OrgMember = {
     invitedBy?: string;
     createdAt: number;
 };
+type CollectionMembershipRole$1 = 'from' | 'to' | 'ends' | 'first' | 'second';
 type RefsResult$1 = {
     items: Array<{
         wref: string;
@@ -1259,6 +1295,12 @@ type SubmittedStreamResult = {
     createdByEmail?: string;
     message: string | undefined;
     operationCount: number;
+    /**
+     * Sequence acknowledged for the last chunk that persisted a visibility
+     * event when `returnRepoSeq` was requested. No-op or all-failed chunks do
+     * not erase an earlier chunk's acknowledgement.
+     */
+    repoSeq?: number;
     partial?: boolean;
     statusCounts?: {
         applied: number;
@@ -1442,6 +1484,8 @@ declare function submitOperationsViaStream(client: OperationStreamClient, args:
     chunkSize?: number;
     skipExisting?: boolean;
     streamId?: string;
+    /** Return the writer's own repository-sequence acknowledgement. */
+    returnRepoSeq?: boolean;
     /**
      * Bounded auto-idempotency retry for transient first-chunk failures.
      * Default-on (3 attempts, 250ms base, 8s cap, jittered exponential).
@@ -1900,6 +1944,7 @@ declare class OperationBuilder {
      * @param params.committer Optional wref identifying the actor on whose behalf the write is made.
      * @param params.chunkSize Maximum operations per stream append.
      * @param params.streamId Advanced continuation hook for caller-managed streams.
+     * @param params.returnRepoSeq Return the writer's own repository-sequence acknowledgement.
      * @param params.retry Retry policy for transient first-chunk failures, or `false` to disable automatic retry.
      * @see https://docs.warmhub.ai/sdk-reference/classes/operationbuilder/#commit
      */
@@ -1911,6 +1956,7 @@ declare class OperationBuilder {
         message?: string;
         chunkSize?: number;
         streamId?: string;
+        returnRepoSeq?: boolean;
         retry?: RetryPolicyOptions | false;
     }): Promise<OperationSubmitResult$1>;
     private assertNotSubmitted;
@@ -2697,6 +2743,7 @@ type ThingItem = {
     active?: boolean;
     data?: unknown;
     aboutWref?: string;
+    roles?: CollectionMembershipRole[];
     metadata?: ThingMetadata;
     [key: string]: unknown;
 };
@@ -2990,8 +3037,11 @@ type SubscriptionBindCredentialsResult = SubscriptionBindCredentialsResult$1;
 /** @internal */
 type SubscriptionUnbindCredentialsResult = SubscriptionUnbindCredentialsResult$1;
 /** @internal */
+type CollectionMembershipRole = CollectionMembershipRole$1;
+/** @internal */
 type Assertion = ThingDetail & {
     children: Assertion[];
+    roles?: CollectionMembershipRole[];
 };
 /** @internal */
 type AboutResult = {
@@ -3036,6 +3086,7 @@ type AboutOptions = {
     includeRetracted?: boolean;
     depth?: number;
     resolveCollections?: boolean;
+    role?: 'from' | 'to' | 'ends';
     limit?: number;
     cursor?: string;
     where?: WherePredicate[];
@@ -3107,6 +3158,8 @@ type FilterOptions = {
     excludeInfraShapes?: boolean;
     /** Expand collection targets to their members in the result. */
     resolveCollections?: boolean;
+    /** Keep collection-resolved assertions where the target occupies this role. */
+    role?: 'from' | 'to' | 'ends';
     /**
      * Field-value WHERE predicates (ANDed). Each predicate must target a pinned/ready
      * field for typed-index routing; unavailable or unindexable fields return a
@@ -3124,7 +3177,7 @@ type FilterOptions = {
  *
  * @see https://docs.warmhub.ai/sdk/read-semantics/#search-modes
  */
-type SearchOptions = Omit<FilterOptions, 'where'> & {
+type SearchOptions = Omit<FilterOptions, 'where' | 'role'> & {
     /** Restrict the search to assertions about this wref target. */
     about?: string;
     /** Search mode: `text` (BM25), `vector` (semantic), or `hybrid` (combined). Defaults to `text`. */
@@ -3141,7 +3194,7 @@ type SearchOptions = Omit<FilterOptions, 'where'> & {
  * pagination fields (`limit`, `cursor`) are ignored.
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/countoptions/
  */
-type CountOptions = FilterOptions;
+type CountOptions = Omit<FilterOptions, 'role'>;
 /**
  * Options for `client.thing.refs` — wref-field reverse and forward lookups.
  *
@@ -3629,6 +3682,10 @@ declare class WarmHubClient {
          * @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.
          * @param opts.streamId Advanced continuation hook for caller-managed streams.
+         * @param opts.returnRepoSeq Return the sequence allocated to the writer's
+         * own commit acknowledgement. This does not disclose a reader-facing
+         * repository head. Multi-chunk submissions return the last sequence
+         * actually allocated; a later no-op or failed chunk does not erase it.
          * @param opts.retry Retry policy for transient first-chunk failures, or `false` to disable automatic retry.
          */
         apply: (orgName: string, repoName: string, message: string | undefined, operations: Operation[], opts?: {
@@ -3637,6 +3694,7 @@ declare class WarmHubClient {
             chunkSize?: number;
             skipExisting?: boolean;
             streamId?: string;
+            returnRepoSeq?: boolean;
             retry?: RetryPolicyOptions | false;
         }) => Promise<OperationSubmitResult>;
     };
@@ -4803,4 +4861,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 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 };
+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 CollectionMembershipRole, 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-GHJFQ6F7.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-AFP7ZGMR.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react.js

@@ -1,5 +1,5 @@
-import { WarmHubClient } from './chunk-GHJFQ6F7.js';
-export { DEFAULT_API_URL, SDK_VERSION, WarmHubClient, WarmHubError, toWarmHubError } from './chunk-GHJFQ6F7.js';
+import { WarmHubClient } from './chunk-AFP7ZGMR.js';
+export { DEFAULT_API_URL, SDK_VERSION, WarmHubClient, WarmHubError, toWarmHubError } from './chunk-AFP7ZGMR.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.73.0",
+  "version": "0.74.0",
   "private": false,
   "type": "module",
   "description": "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",