@warmhub/sdk-ts 0.45.0 → 0.46.0

package/dist/index.d.ts

@@ -81,10 +81,12 @@ type CommitApplyResult = {
     message?: string;
     operationCount: number;
     operations: Array<{
+        opIndex?: number;
         name: string;
         operation: 'add' | 'revise' | 'retract' | 'noop';
         version: number;
         dataHash: string;
+        status?: 'applied' | 'noop';
         warnings?: {
             undeclaredFields: Array<string>;
             undeclaredFieldsTruncated?: true;
@@ -214,6 +216,7 @@ type StreamAppendInput$1 = {
     componentId?: string;
     workspaceName?: never;
     committer?: string;
+    message?: string;
     allocatedTokens?: Array<{
         tokenNumber: number;
     }>;
@@ -281,6 +284,7 @@ type StreamAppendResult$1 = {
         tokenNumber: number;
     }>;
     results: Array<{
+        opIndex?: number;
         name: string;
         operation?: 'add' | 'revise' | 'retract' | 'noop';
         version?: number;
@@ -290,12 +294,15 @@ type StreamAppendResult$1 = {
             code: string;
             message: string;
         };
+        resolvedName?: string;
+        retryable?: boolean;
         warnings?: {
             undeclaredFields: Array<string>;
             undeclaredFieldsTruncated?: true;
             totalUndeclared?: number;
         };
     }>;
+    createdByEmail?: string;
     appendTotalMs?: number;
     appendResolveRepoMs?: number;
     appendTokenResolveMs?: number;
@@ -572,7 +579,7 @@ type WireScopeEntry$1 = {
  * Add operation accepted by `client.commit.apply`. Use this shape to create new
  * shapes, things, assertions, or collections in a single commit.
  *
- * @see https://docs.warmhub.ai/commits/operations/#add-operations
+ * @see https://docs.warmhub.ai/writes/operations/#add-operations
  */
 interface AddOperation {
     /**
@@ -622,7 +629,7 @@ interface AddOperation {
  * field is declared `never` at the type level, so passing `active: false` is
  * a compile error. Use a {@link RetractOperation} to mark an entity inactive.
  *
- * @see https://docs.warmhub.ai/commits/operations/#revise-operations
+ * @see https://docs.warmhub.ai/writes/operations/#revise-operations
  */
 interface ReviseOperation {
     /**
@@ -656,7 +663,7 @@ interface ReviseOperation {
  * Retract operation accepted by `client.commit.apply`. Marks the target as
  * retracted in a new version; prior versions remain queryable by history.
  *
- * @see https://docs.warmhub.ai/commits/operations/#retract-operations
+ * @see https://docs.warmhub.ai/writes/operations/#retract-operations
  */
 interface RetractOperation {
     /**
@@ -705,18 +712,20 @@ interface RetractOperation {
  * await client.commit.apply("acme", "world", "seed", ops);
  * ```
  *
- * @see https://docs.warmhub.ai/sdk/commit-vs-builder/#typing-operation-arrays
+ * @see https://docs.warmhub.ai/sdk/write-methods/#typing-operation-arrays
  */
 type Operation = AddOperation | ReviseOperation | RetractOperation;
 
 /**
  * Default number of operations the SDK sends per stream append chunk.
- * @see https://docs.warmhub.ai/sdk-reference/variables/default_stream_chunk_size/
+ *
+ * @internal
  */
 declare const DEFAULT_STREAM_CHUNK_SIZE = 1000;
 /**
  * Maximum number of operations accepted by one stream append chunk.
- * @see https://docs.warmhub.ai/sdk-reference/variables/max_stream_append_operation_count/
+ *
+ * @internal
  */
 declare const MAX_STREAM_APPEND_OPERATION_COUNT = 10000;
 interface OperationStreamClient {
@@ -726,18 +735,29 @@ interface OperationStreamClient {
 }
 type SubmittedStreamResult = {
     committer?: string;
+    createdByEmail?: string;
     message: string | undefined;
     operationCount: number;
+    partial?: boolean;
+    statusCounts?: {
+        applied: number;
+        noop: number;
+        error: number;
+    };
     operations: Array<{
+        opIndex?: number;
         name: string;
         operation: 'add' | 'revise' | 'retract' | 'noop';
         dataHash: string;
         version: number;
-        status?: 'success' | 'noop' | 'failed';
+        status?: 'applied' | 'noop' | 'error';
         error?: {
             code: string;
             message: string;
         };
+        submittedName?: string;
+        resolvedName?: string;
+        retryable?: boolean;
         /**
          * Non-blocking warnings collected during shape validation — see GH-1418.
          * Aliased to the generated wire shape so this type cannot drift from
@@ -746,6 +766,10 @@ type SubmittedStreamResult = {
         warnings?: NonNullable<StreamAppendResult$1['results'][number]['warnings']>;
     }>;
 };
+/** @internal */
+declare function streamAppendResultStatus(result: StreamAppendResult$1['results'][number]): NonNullable<SubmittedStreamResult['operations'][number]['status']>;
+/** @internal */
+declare function countStreamAppendResultStatuses(results: StreamAppendResult$1['results']): NonNullable<SubmittedStreamResult['statusCounts']>;
 /**
  * Continuation state for caller-managed streamed commit submissions.
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/streamcontinuationstate/
@@ -769,6 +793,10 @@ type RetryPolicyOptions = {
     baseDelayMs?: number;
     maxDelayMs?: number;
 };
+type StreamFailureCause = {
+    code: string;
+    message: string;
+};
 /**
  * Error raised when a streamed commit submission fails after an ambiguous or
  * partial append.
@@ -802,6 +830,19 @@ declare class PartialStreamSubmissionError extends Error {
         completedOperations: SubmittedStreamResult['operations'];
     });
 }
+/**
+ * Error raised when the stream append path completed deterministically but
+ * every submitted operation failed.
+ * @see https://docs.warmhub.ai/sdk-reference/classes/allstreamoperationsfailederror/
+ */
+declare class AllStreamOperationsFailedError extends Error {
+    readonly code = "STREAM_ALL_OPERATIONS_FAILED";
+    readonly result: SubmittedStreamResult;
+    readonly operations: SubmittedStreamResult['operations'];
+    readonly statusCounts: NonNullable<SubmittedStreamResult['statusCounts']>;
+    readonly cause?: StreamFailureCause;
+    constructor(result: SubmittedStreamResult);
+}
 /**
  * Submit `operations` to the WarmHub stream-append surface, chunked to
  * stay under MAX_STREAM_APPEND_OPERATION_COUNT.
@@ -879,6 +920,7 @@ declare class PartialStreamSubmissionError extends Error {
  * full idempotency contract.
  *
  * @see https://docs.warmhub.ai/sdk/transient-retry/
+ * @internal
  */
 declare function submitOperationsViaStream(client: OperationStreamClient, args: {
     orgName: string;
@@ -910,6 +952,61 @@ type CollectionAbout$1 = {
     list: string[];
 };
 
+/**
+ * Canonical request signing for component CLI dispatch.
+ *
+ * Component workers expose CLI methods over HTTP. The platform dispatcher
+ * signs each call with HMAC-SHA256 over a canonical request representation
+ * so the worker can authenticate the caller without sharing more than a
+ * single secret. The same canonical input works for GET and POST methods:
+ * the difference is whether the method args ride in the query string or
+ * the body.
+ *
+ *   Canonical signing input:
+ *     <METHOD>\n<PATH>\n<CANONICAL_QUERY>\n<INSTALL_REPO>\n<SHA256_HEX(BODY)>\n<TIMESTAMP>
+ *
+ * Where:
+ *   - METHOD is the uppercased HTTP method ('GET' | 'POST').
+ *   - PATH is the URL path component (no scheme, host, or query).
+ *   - CANONICAL_QUERY is `canonicalCliQueryString(query)` — sorted, RFC 3986
+ *     percent-encoded, omitting undefined / null entries.
+ *   - INSTALL_REPO is the `<org>/<repo>` slug of the install, transmitted on
+ *     the wire as the `X-WarmHub-Install-Repo` header.
+ *   - BODY is the raw request body string ('' for GET).
+ *   - TIMESTAMP is unix-seconds since epoch (string-formatted).
+ *
+ * Verifiers should enforce a tolerance window on the timestamp to bound
+ * replay attacks (default 300 s); they should also compare signatures in
+ * constant time.
+ *
+ * This module is intentionally low-level: component authors import the
+ * higher-level `verifyCliCall(request, secret)` wrapper from
+ * `@warmhub/sdk-ts`, which extracts the canonical inputs from a Fetch
+ * `Request` and calls `verifyCliRequest` for them.
+ */
+/**
+ * Wire header names for component CLI dispatch — the single source of truth
+ * shared by the backend dispatcher (which sets them) and `verifyCliCall` (which
+ * reads them). The install repo always rides in {@link CLI_INSTALL_REPO_HEADER};
+ * the signing scheme adds {@link CLI_SIGNATURE_HEADER} + {@link CLI_TIMESTAMP_HEADER}.
+ * @see https://docs.warmhub.ai/sdk-reference/variables/cli_install_repo_header/
+ */
+declare const CLI_INSTALL_REPO_HEADER = "X-WarmHub-Install-Repo";
+/**
+ * @see https://docs.warmhub.ai/sdk-reference/variables/cli_signature_header/
+ */
+declare const CLI_SIGNATURE_HEADER = "X-WarmHub-Signature";
+/**
+ * @see https://docs.warmhub.ai/sdk-reference/variables/cli_timestamp_header/
+ */
+declare const CLI_TIMESTAMP_HEADER = "X-WarmHub-Timestamp";
+/**
+ * HTTP verbs a component CLI method can declare. No-body verbs (GET, DELETE)
+ * carry args in the query string; body verbs (POST, PUT, PATCH) carry args in
+ * the JSON body.
+ */
+type CliHttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+
 /**
  * Hardcoded meta-schema for validating shape definitions.
  * Shapes are NOT validated against a DB-stored shape — they validate against this constant.
@@ -991,6 +1088,103 @@ type ShapeValidatorResult = {
     warnings?: UndeclaredFieldsWarning;
 };
 
+/**
+ * Server-side verifier for component CLI dispatch calls.
+ *
+ * Workers that expose CLI methods declared in their component manifest
+ * receive authenticated requests from the WarmHub platform. The platform
+ * supports four CLI auth schemes (selected via the component's
+ * `credentials[]` entry) and this verifier accepts a request authenticated
+ * under whichever schemes the install configured:
+ *
+ *   1. `CLI_SIGNING_SECRET` — HMAC-SHA256 over the canonical request,
+ *      transmitted as `X-WarmHub-Signature` + `X-WarmHub-Timestamp`.
+ *   2. `CLI_BEARER_TOKEN`   — `Authorization: Bearer <token>`.
+ *   3. `CLI_API_KEY` (+ optional `CLI_API_KEY_HEADER`, default `X-API-Key`)
+ *      — custom header carrying the key.
+ *   4. `CLI_BASIC_USERNAME` + `CLI_BASIC_PASSWORD` — `Authorization: Basic …`.
+ *
+ * Multiple schemes can be configured at once; in that case the verifier
+ * requires ALL of them to validate (downgrade-attack defense — an attacker
+ * who learns only one credential can't drop the other from the request).
+ * If none are configured, the call is rejected as misconfigured.
+ *
+ *   import { verifyCliCall } from '@warmhub/sdk-ts'
+ *
+ *   app.get('/list-reputations', async (c) => {
+ *     const { args, installRepo } = await verifyCliCall(c.req.raw, c.env)
+ *     return c.json(await listReputations(db, args.scope, args.limit, args.cursor))
+ *   })
+ *
+ * Wire format (orthogonal to the auth scheme):
+ *   - GET / DELETE: method args ride in the URL query string. Body is empty.
+ *   - POST / PUT / PATCH: method args are the JSON body (no envelope wrapper).
+ *   - The install repo always rides in `X-WarmHub-Install-Repo`.
+ *
+ * Throws `CliCallVerificationError` on any failure. The error's `reason`
+ * field is one of a small fixed set so callers can map onto HTTP statuses
+ * without string-matching messages.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/clicallverificationfailurereason/
+ */
+
+type CliCallVerificationFailureReason = 'missing-signature' | 'missing-timestamp' | 'invalid-timestamp' | 'missing-install-repo' | 'unsupported-method' | 'invalid-signature' | 'invalid-format' | 'expired' | 'invalid-body' | 'no-scheme-configured' | 'invalid-bearer' | 'invalid-api-key' | 'invalid-basic';
+/**
+ * @see https://docs.warmhub.ai/sdk-reference/classes/clicallverificationerror/
+ */
+declare class CliCallVerificationError extends Error {
+    readonly reason: CliCallVerificationFailureReason;
+    constructor(reason: CliCallVerificationFailureReason, message: string);
+}
+/**
+ * @see https://docs.warmhub.ai/sdk-reference/interfaces/verifiedclicall/
+ */
+interface VerifiedCliCall {
+    /** HTTP method the request arrived on. */
+    method: CliHttpMethod;
+    /**
+     * `<org>/<repo>` slug of the install, from the install-repo header.
+     *
+     * Only cryptographically bound under the signing scheme (the HMAC covers the
+     * install repo). Under token schemes (bearer / api-key / basic) it is
+     * caller-asserted — verifying the request does NOT prove the caller is
+     * entitled to this install. When the install repo drives authorization, bind
+     * it (resolve the per-install secret keyed by this value and verify with it)
+     * or require the signing scheme. See docs/dev/component-rules.md → "What each
+     * scheme binds".
+     */
+    installRepo: string;
+    /** Method args — query params for GET, parsed JSON body for POST/PUT/PATCH. */
+    args: Record<string, string | number | boolean | undefined>;
+}
+/**
+ * Secret bundle accepted by `verifyCliCall`. Pass your worker's full env
+ * (e.g. `c.env`) or just the CLI_* subset — the verifier looks only at the
+ * keys it knows.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/clicallsecrets/
+ */
+type CliCallSecrets = Partial<{
+    CLI_SIGNING_SECRET: string;
+    CLI_BEARER_TOKEN: string;
+    CLI_API_KEY: string;
+    /** Custom header name for `CLI_API_KEY`. Defaults to `X-API-Key`. */
+    CLI_API_KEY_HEADER: string;
+    CLI_BASIC_USERNAME: string;
+    CLI_BASIC_PASSWORD: string;
+}> & Record<string, string | undefined>;
+/**
+ * Verify and parse an inbound component CLI call.
+ *
+ * @param request - The Fetch `Request` as received by the worker.
+ * @param secrets - Credential set values (see `CliCallSecrets`).
+ * @param opts    - Optional overrides. `nowUnixSeconds` defaults to the
+ *                  current wall clock; `toleranceSec` defaults to 300 s.
+ * @see https://docs.warmhub.ai/sdk-reference/functions/verifyclicall/
+ */
+declare function verifyCliCall(request: Request, secrets: CliCallSecrets, opts?: {
+    nowUnixSeconds?: number;
+    toleranceSec?: number;
+}): Promise<VerifiedCliCall>;
+
 /**
  * Shape field definitions — the value side of a shape's data.fields
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/shapefields/
@@ -1169,7 +1363,7 @@ type ReviseInput = Omit<ReviseOp, 'operation'> | ReviseOp;
  * const result = await cb.commit({ client, orgName: "acme", repoName: "world" });
  * ```
  *
- * @see https://docs.warmhub.ai/sdk/commit-vs-builder/
+ * @see https://docs.warmhub.ai/sdk/write-methods/
  */
 declare class OperationBuilder {
     private readonly ops;
@@ -1257,7 +1451,7 @@ declare class OperationBuilder {
     /**
      * Validate, submit, and seal the builder.
      *
-     * A successful call submits operations through the same stream path as `client.commit.apply` and makes the builder single-use. Validation failures throw before any server request is made. Ambiguous multi-chunk failures surface as `PartialStreamSubmissionError`.
+     * A successful call submits operations through the same stream path as `client.commit.apply` and makes the builder single-use. Validation failures throw before any server request is made. Ambiguous multi-chunk failures surface as `PartialStreamSubmissionError`; deterministic all-failed batches surface as `AllStreamOperationsFailedError` with per-op failure data.
      *
      * @param params.client WarmHub client or compatible stream client used for submission.
      * @param params.message Optional commit message.
@@ -2367,6 +2561,16 @@ declare function isConnectionError(error: unknown): boolean;
  * @see https://docs.warmhub.ai/sdk-reference/functions/connectionerrormessage/
  */
 declare function connectionErrorMessage(url: string): string;
+/**
+ * Returns true when `version` is strictly older than `minimum`. Both
+ * arguments must parse as semver-shaped strings (major.minor.patch with
+ * optional prerelease and build metadata); non-parseable inputs return
+ * false (fail-open) so a malformed `minSupportedSdk` from a future
+ * backend cannot brick existing clients.
+ *
+ * @internal
+ */
+declare function sdkVersionIsBelowMinimum(version: string, minimum: string): boolean;
 /**
  * Primary TypeScript client for the WarmHub API.
  *
@@ -2390,6 +2594,7 @@ declare class WarmHubClient {
     protected readonly functionLogMode: FunctionLogMode;
     protected readonly getToken?: () => Promise<string | undefined>;
     private readonly trpc;
+    private compatibilityCheck?;
     /**
      * Authentication helpers for browser sign-in flows, session checks, and token diagnostics.
      * @see https://docs.warmhub.ai/sdk-reference/classes/warmhubclient/#auth
@@ -2451,6 +2656,20 @@ declare class WarmHubClient {
          * Return backend API version, minimum supported SDK version, and feature flags.
          */
         capabilities: () => Promise<Capabilities>;
+        /**
+         * Verify the installed SDK is at or above the backend's advertised
+         * minimum supported version, throwing a `WarmHubError` with a clear
+         * "upgrade to >=X" message when it is not.
+         *
+         * Call this once at startup (e.g. immediately after constructing the
+         * client) to fail fast on SDK version skew, rather than discovering a
+         * removed route deep in the commit pipeline as an opaque error.
+         * The result is cached on the client instance — repeated calls reuse
+         * the first network round-trip and re-throw the same error if too old.
+         *
+         * @see https://github.com/warmhub/warmhub-app/issues/3081
+         */
+        assertCompatible: () => Promise<void>;
     };
     /**
      * Installed component inspection for packages that add shapes, subscriptions, credentials, and seed data to a repository.
@@ -2515,7 +2734,7 @@ declare class WarmHubClient {
     /**
      * High-level write surface for submitting WarmHub operations through the commit pipeline.
      *
-     * @see https://docs.warmhub.ai/sdk/commit-vs-builder/
+     * @see https://docs.warmhub.ai/sdk/write-methods/
      */
     readonly commit: {
         /**
@@ -2523,7 +2742,7 @@ declare class WarmHubClient {
          *
          * This is the primary write path for SDK callers. It streams operations to the backend, preserves server-side per-operation results, supports chunking for large submissions, and can attribute writes to a committer wref or installed component.
          *
-         * Simple first-chunk transport failures are retried by default. Multi-chunk ambiguous failures are surfaced as `PartialStreamSubmissionError` so callers can inspect repository state before deciding whether to resume or retry. See [Transient Retry](/sdk/transient-retry/) for the full retry and partial-submission rules.
+         * Simple first-chunk transport failures are retried by default. Ambiguous failures surface as `PartialStreamSubmissionError`, including the case where an ambiguous attempt is followed by an all-failed retry; inspect `error.cause` for the underlying `AllStreamOperationsFailedError` or backend error. Deterministic all-failed submissions without prior ambiguity throw `AllStreamOperationsFailedError` directly so callers can inspect per-operation failure rows. Validation, auth, conflict, rate-limit, and other definite backend failures surface as `WarmHubError`. See [Transient Retry](/sdk/transient-retry/) for the full retry and partial-submission rules.
          *
          * Writing to an archived organization or repository fails with an `ARCHIVED` error before any operations are applied.
          *
@@ -2670,7 +2889,7 @@ declare class WarmHubClient {
          *
          * The returned `total` is the sum of active shapes, things, and assertions. Use this when billing, quota checks, health reports, or per-shape breakdowns need single-repo stats.
          *
-         * The per-shape breakdown counts active things by shape; assertions are not included in that map.
+         * The per-shape breakdown counts active things and assertions by shape.
          */
         getStats: (orgName: string, repoName: string) => Promise<RepoStatsView>;
         /**
@@ -3394,4 +3613,4 @@ declare class WarmHubClient {
     private watchRepoQuery;
 }
 
-export { type AboutOptions, type AboutResult, type AccessTokenProvider, type ActionAttemptInfo, type ActionLeaseAcquire, type ActionLeaseOp, type ActionListNotificationsOptions, type ActionListRunsOptions, type ActionLiveFeed, type ActionLiveFeedOptions, type ActionNotificationInfo, type ActionRunInfo, type AddOp, type AddOperation, type Assertion, CONTENT_FIELD_LIMIT_ERROR, type CollectionAbout, type CollectionTag, type ComponentInfo, type ComponentInstallSystemResult, type ComponentList, type ComponentListOptions, 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 HeadResult, type HistoryResult, 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 OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationSubmitResult, 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 RenameResult, type RepoConfigureStatsView, type RepoDescribeResult, type RepoInfo, type RepoList, type RepoListOptions, type RepoListPageOptions, type RepoListPageResult, type RepoLocator, 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 ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadOptions, type ThingHeadRequest, type ThingHistory, type ThingHistoryOptions, type ThingItem, type TokenInfo, type TokenResult, type UndeclaredFieldsWarning, type ValidationDiagnostic, type ValidationResult, WarmHubClient, type WarmHubClientOptions, WarmHubError, type WherePredicate, type WhoamiInfo, type WhoamiScopeEntry, type WireScopeEntry, connectionErrorMessage, contentFieldLimitError, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, submitOperationsViaStream, toWarmHubError, validateAgainstShape };
+export { type AboutOptions, type AboutResult, type AccessTokenProvider, type ActionAttemptInfo, type ActionLeaseAcquire, type ActionLeaseOp, type ActionListNotificationsOptions, type ActionListRunsOptions, type ActionLiveFeed, type ActionLiveFeedOptions, type ActionNotificationInfo, type ActionRunInfo, 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 CollectionTag, type ComponentInfo, type ComponentInstallSystemResult, type ComponentList, type ComponentListOptions, 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 HeadResult, type HistoryResult, 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 OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationSubmitResult, 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 RenameResult, type RepoConfigureStatsView, type RepoDescribeResult, type RepoInfo, type RepoList, type RepoListOptions, type RepoListPageOptions, type RepoListPageResult, type RepoLocator, 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 ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadOptions, type ThingHeadRequest, type ThingHistory, type ThingHistoryOptions, type ThingItem, type TokenInfo, type TokenResult, type UndeclaredFieldsWarning, type ValidationDiagnostic, type ValidationResult, type VerifiedCliCall, WarmHubClient, type WarmHubClientOptions, WarmHubError, 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 { CONTENT_FIELD_LIMIT_ERROR, DEFAULT_API_URL, DEFAULT_STREAM_CHUNK_SIZE, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT, OperationBuilder, PartialStreamSubmissionError, SDK_VERSION, WarmHubClient, WarmHubError, connectionErrorMessage, contentFieldLimitError, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, submitOperationsViaStream, toWarmHubError, validateAgainstShape } from './chunk-ERGCQLFH.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-RX3ZL6P5.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react.js

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

package/package.json

@@ -1,9 +1,33 @@
 {
   "name": "@warmhub/sdk-ts",
-  "version": "0.45.0",
+  "version": "0.46.0",
   "private": false,
   "type": "module",
-  "homepage": "https://docs.warmhub.ai",
+  "description": "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
+  "keywords": [
+    "warmhub",
+    "sdk",
+    "typescript",
+    "ai",
+    "agents",
+    "mcp",
+    "knowledge",
+    "knowledge-graph",
+    "assertions",
+    "trust",
+    "trpc"
+  ],
+  "author": {
+    "name": "WarmHub",
+    "url": "https://warmhub.ai"
+  },
+  "homepage": "https://docs.warmhub.ai/get-started/quickstart/#connect-via-sdk",
+  "bugs": {
+    "email": "support@warmhub.com"
+  },
+  "engines": {
+    "node": ">=22"
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "sideEffects": false,