@warmhub/sdk-ts 0.74.0 → 0.75.0

package/dist/index.d.ts

@@ -1361,9 +1361,11 @@ type StreamFailureCause = {
  * Error raised when a streamed commit submission fails after an ambiguous or
  * partial append.
  *
- * The `completedOperations` field contains operations the SDK knows completed.
- * Before retrying manually, inspect repository state because the failed append
- * may have committed additional operations that were not reflected locally.
+ * The `completedOperations` field contains returned rows the SDK knows
+ * completed. `acknowledgedOperationCount` also records progress when an append
+ * response contains sparse or empty result rows. Before retrying manually,
+ * inspect repository state because the failed append may have committed
+ * additional operations that were not reflected locally.
  *
  * @see https://docs.warmhub.ai/sdk/transient-retry/#partial-submissions
  */
@@ -1379,6 +1381,13 @@ declare class PartialStreamSubmissionError extends Error {
      * @see https://docs.warmhub.ai/sdk-reference/classes/partialstreamsubmissionerror/#completedoperations
      */
     readonly completedOperations: SubmittedStreamResult['operations'];
+    /**
+     * Number of operations covered by append responses the SDK received before
+     * the failure. This can exceed `completedOperations.length` when the backend
+     * returns sparse or empty result rows.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/partialstreamsubmissionerror/#acknowledgedoperationcount
+     */
+    readonly acknowledgedOperationCount: number;
     /**
      * Underlying error that triggered the partial submission, preserved for
      * diagnostics. Inspect via `isWarmHubError(err.cause)` / `err.cause.kind`.
@@ -1388,6 +1397,7 @@ declare class PartialStreamSubmissionError extends Error {
     constructor(input: {
         cause: unknown;
         completedOperations: SubmittedStreamResult['operations'];
+        acknowledgedOperationCount?: number;
     });
 }
 /**
@@ -1420,9 +1430,9 @@ 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. 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.
+ * prefix. Multi-chunk mid-flight failures (`acknowledgedOperationCount > 0`)
+ * also bypass retry. Both surface `PartialStreamSubmissionError`; callers must
+ * inspect repository state and resume only operations known not to have landed.
  *
  * Definite client rejections (`UNAUTHENTICATED`, `VALIDATION_ERROR`,
  * `CONFLICT`, `RATE_LIMITED`, `ALREADY_RETRACTED`, …) on the first chunk
@@ -1837,7 +1847,9 @@ type ReviseInput = Omit<ReviseOp, 'operation'> | ReviseOp;
  * The builder is not a promise — there is no `build()` method, and `await cb`
  * alone will not submit anything. Finalize the batch by calling
  * `await cb.commit({ client, orgName, repoName, ... })`, which validates,
- * submits, and seals the builder in one step. Reusing a sealed builder throws.
+ * submits, and seals the builder in one step. A partial submission also seals
+ * the builder because some operations may have landed. Reusing a sealed
+ * builder throws.
  *
  * @example
  * ```ts
@@ -1937,7 +1949,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`; deterministic all-failed batches surface as `AllStreamOperationsFailedError` with per-op failure data.
+     * A successful call submits operations through the same stream path as `client.commit.apply` and makes the builder single-use. A `PartialStreamSubmissionError` also seals the builder to prevent blind replay. Validation failures throw before any server request is made. 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.

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-AFP7ZGMR.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-QQTES2LQ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react.js

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