@warmhub/sdk-ts 0.83.0 → 0.85.0

package/dist/index.d.ts

@@ -1,179 +1,3 @@
-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];
-
-/**
- * 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";
-/**
- * HMAC signature header used by component CLI dispatch.
- * @see https://docs.warmhub.ai/sdk-reference/variables/cli_signature_header/
- */
-declare const CLI_SIGNATURE_HEADER = "X-WarmHub-Signature";
-/**
- * Unix-seconds timestamp header used by component CLI dispatch.
- * @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';
-
-/** Every event type a webhook subscription can watch. */
-declare const SUBSCRIBABLE_EVENT_TYPES: readonly ["commit", "repo.renamed", "org.renamed", "org.member_added", "org.repo_created", "org.repo_published", "thing.renamed", "shape.renamed"];
-type SubscribableEventType = (typeof SUBSCRIBABLE_EVENT_TYPES)[number];
-/** Org-scoped events — created with an `orgName` and no `repoName`. */
-declare const ORG_SCOPED_EVENT_TYPES: readonly ["org.renamed", "org.member_added", "org.repo_created", "org.repo_published"];
-type OrgScopedEventType = (typeof ORG_SCOPED_EVENT_TYPES)[number];
-
-/**
- * Validate a data payload against shape field definitions.
- *
- * Shape field types:
- * - "number", "string", "boolean": primitive types
- * - "wref": string (reference to a shape or shaped thing)
- * - Typed field objects: { type: primitive, description?: string }
- * - Nested objects: { fieldName: type, ... }
- * - Arrays: [elementType]
- * - Optional fields: field name ending with "?" (e.g. "terminal_reason?": "string")
- *   OR type string ending with "?" (e.g. "terminal_reason": "string?")
- *   OR typed object type ending with "?" (e.g. { type: "string?" })
- *
- * For v1 this is permissive: validates top-level field existence and basic types.
- * Returns a {@link ShapeValidatorResult} discriminated union — read `result.valid`
- * to branch, then `result.errors` (only present when invalid) for the list of
- * messages. `result.warnings` may be present in either branch and carries
- * undeclared top-level field names.
- *
- * @example
- * ```ts
- * import { validateAgainstShape } from "@warmhub/sdk-ts";
- *
- * const shapeFields = { x: "number", y: "number", label: "string?" };
- *
- * const ok = validateAgainstShape({ x: 1, y: 2 }, shapeFields);
- * // ok.valid === true
- *
- * const bad = validateAgainstShape({ x: "not-a-number" }, shapeFields);
- * if (!bad.valid) {
- *   for (const message of bad.errors) console.error(message);
- *   // ['Field "x" must be a number', 'Missing required field: "y"']
- * }
- * ```
- * @see https://docs.warmhub.ai/sdk-reference/functions/validateagainstshape/
- */
-declare function validateAgainstShape(data: Record<string, unknown>, shapeFields: Record<string, unknown>): ShapeValidatorResult;
-/**
- * Warning details for input fields that the shape does not declare.
- * @see https://docs.warmhub.ai/sdk-reference/type-aliases/undeclaredfieldswarning/
- */
-type UndeclaredFieldsWarning = {
-    undeclaredFields: string[];
-    undeclaredFieldsTruncated?: true;
-    totalUndeclared?: number;
-};
-/**
- * Discriminated result returned when input is validated against shape fields.
- * @see https://docs.warmhub.ai/sdk-reference/type-aliases/shapevalidatorresult/
- */
-type ShapeValidatorResult = {
-    valid: true;
-    warnings?: UndeclaredFieldsWarning;
-} | {
-    valid: false;
-    errors: string[];
-    warnings?: UndeclaredFieldsWarning;
-};
-
-/**
- * Hardcoded meta-schema for validating shape definitions.
- * Shapes are NOT validated against a DB-stored shape — they validate against this constant.
- * This avoids the bootstrap chicken-and-egg problem.
- *
- * A valid shape definition is:
- * { fields: Record<string, TypeSpec>, description?: string }
- * where TypeSpec is one of:
- *   - primitive string: "number", "string", "boolean", "wref", "array"
- *   - optional primitive: "number?", "string?", "boolean?", "wref?", "array?"
- *   - typed field object: { type: primitive, description?: string }
- *   - array: [TypeSpec] (shorthand) or { type: "array", items: TypeSpec }
- *   - nested object: { fieldName: TypeSpec, ... } (key may end with "?" for optional)
- *
- * The primitive vocabulary above is closed: any other type name (e.g. "text",
- * "integer", "json", "date") is rejected. See VALID_PRIMITIVE_TYPES in
- * ./shape-types.ts for the authoritative set.
- * String `pattern` constraints use RE2 syntax and are evaluated with re2js so
- * user-authored patterns run in linear time across backend, SDK, web, CLI, and
- * worker-adjacent consumers. JavaScript-only constructs such as backreferences
- * and lookarounds are rejected at shape-definition time.
- */
-
-/**
- * Maximum size, in bytes (UTF-8 encoded), allowed for a single content field value.
- * WarmHub is not a document store: values larger than this are rejected at validation.
- * Store large documents in S3, Box, Drive, or another document system and reference
- * them from WarmHub instead.
- * @see https://docs.warmhub.ai/sdk-reference/variables/max_content_field_bytes/
- */
-declare const MAX_CONTENT_FIELD_BYTES: number;
-/**
- * Human-readable explanation of the {@link MAX_CONTENT_FIELD_BYTES} limit, suitable for
- * appending to a field-specific validation error. States the byte cap and points callers
- * to an external document store for large payloads.
- * @see https://docs.warmhub.ai/sdk-reference/variables/content_field_limit_error/
- */
-declare const CONTENT_FIELD_LIMIT_ERROR: string;
-/**
- * Returns a validation error message if the given string exceeds
- * {@link MAX_CONTENT_FIELD_BYTES} when UTF-8 encoded, or `null` if it is within the limit.
- *
- * @param path - The field path, used to identify the offending field in the message.
- * @param value - The candidate field value to measure.
- * @see https://docs.warmhub.ai/sdk-reference/functions/contentfieldlimiterror/
- */
-declare function contentFieldLimitError(path: string, value: string): string | null;
-
 type ActionAttempt = {
     attempt: number;
     status: string;
@@ -266,7 +90,7 @@ type AccessResolveResult$1 = {
         orgName: string;
         repoName: string;
         visible: boolean;
-        scopes: Array<'repo:read' | 'repo:write' | 'repo:configure' | 'repo:admin' | 'repo:action-callback'>;
+        scopes: Array<'repo:read' | 'repo:checkpoint-read' | 'repo:write' | 'repo:configure' | 'repo:admin' | 'repo:action-callback'>;
         allowedMatches?: Array<string>;
         repoDurableId?: string;
     }>;
@@ -280,12 +104,18 @@ type AuthSyncResult = {
     success: boolean;
 };
 type CollectionTag$1 = 'arc' | 'bond' | 'pair' | 'set' | 'list';
-type CommitApplyResult = {
-    committer?: string;
-    createdByEmail?: string;
-    message?: string;
-    operationCount: number;
-    repoSeq?: number;
+type OperationEventReceiptV1$1 = {
+    event: {
+        committedAt: string;
+        eventDigest: string;
+        operationCount: number;
+        repo: {
+            orgName: string;
+            repoName: string;
+        };
+        repoSeq: string;
+    } | null;
+    eventRequestId: string;
     operations: Array<{
         opIndex?: number;
         name: string;
@@ -310,7 +140,63 @@ type CommitApplyResult = {
                 removalMilestone: string;
             }>;
         };
+    } | {
+        opIndex?: number;
+        name: string;
+        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        version?: number;
+        dataHash?: string;
+        status?: 'success' | 'noop' | 'failed';
+        error?: {
+            code: string;
+            message: string;
+            details?: {
+                reason: 'expected_version_mismatch';
+                expectedVersion: number;
+                currentVersion: number;
+            } | {
+                reason: 'lease_held';
+                leaseExpiresAt: string;
+            } | {
+                reason: 'validation_failed';
+                issues: Array<{
+                    path: string;
+                    message: string;
+                }>;
+            } | {
+                reason: 'rate_limit_reset';
+                retryAfterSeconds: number;
+                resetAt: string;
+            } | {
+                reason: 'cursor_fence_unavailable';
+                cause: 'not_ready' | 'below_floor' | 'above_head';
+                retryFromStart: true;
+            };
+        };
+        resolvedName?: string;
+        retryable?: boolean;
+        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;
+            }>;
+        };
     }>;
+    outcome: 'event' | 'no_event';
+    requestDigest: string;
+    schemaVersion: 'operation-event-receipt/v1';
+    submissionId?: string;
 };
 type CollectionContainsResult$1 = {
     type: 'arc' | 'bond' | 'pair' | 'set' | 'list' | 'triple';
@@ -374,34 +260,8 @@ type CollectionMembersPage$1 = {
     }>;
     nextCursor?: string;
 };
-type CollectionMutationResult$1 = {
-    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';
+type CollectionStatsResult$1 = {
+    type: 'arc' | 'bond' | 'pair' | 'set' | 'list' | 'triple';
     wref: string;
     version: number;
     memberCount: number;
@@ -471,6 +331,101 @@ type ComponentInstallResult$1 = {
     setupCreates: Array<string>;
     errors: Array<string>;
     hasSetup: boolean;
+    submissionId: string;
+    eventReceipts: Array<{
+        event: {
+            committedAt: string;
+            eventDigest: string;
+            operationCount: number;
+            repo: {
+                orgName: string;
+                repoName: string;
+            };
+            repoSeq: string;
+        } | null;
+        eventRequestId: string;
+        operations: Array<{
+            opIndex?: number;
+            name: string;
+            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version: number;
+            dataHash: string;
+            status?: 'applied' | '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;
+                }>;
+            };
+        } | {
+            opIndex?: number;
+            name: string;
+            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version?: number;
+            dataHash?: string;
+            status?: 'success' | 'noop' | 'failed';
+            error?: {
+                code: string;
+                message: string;
+                details?: {
+                    reason: 'expected_version_mismatch';
+                    expectedVersion: number;
+                    currentVersion: number;
+                } | {
+                    reason: 'lease_held';
+                    leaseExpiresAt: string;
+                } | {
+                    reason: 'validation_failed';
+                    issues: Array<{
+                        path: string;
+                        message: string;
+                    }>;
+                } | {
+                    reason: 'rate_limit_reset';
+                    retryAfterSeconds: number;
+                    resetAt: string;
+                } | {
+                    reason: 'cursor_fence_unavailable';
+                    cause: 'not_ready' | 'below_floor' | 'above_head';
+                    retryFromStart: true;
+                };
+            };
+            resolvedName?: string;
+            retryable?: boolean;
+            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;
+                }>;
+            };
+        }>;
+        outcome: 'event' | 'no_event';
+        requestDigest: string;
+        schemaVersion: 'operation-event-receipt/v1';
+        submissionId?: string;
+    }>;
 };
 type ComponentListResult = {
     items: Array<{
@@ -514,6 +469,101 @@ type ComponentUninstallResult$1 = {
     tokensRevoked: number;
     uninstallDispatched: boolean;
     warnings: Array<string>;
+    submissionId: string;
+    eventReceipts: Array<{
+        event: {
+            committedAt: string;
+            eventDigest: string;
+            operationCount: number;
+            repo: {
+                orgName: string;
+                repoName: string;
+            };
+            repoSeq: string;
+        } | null;
+        eventRequestId: string;
+        operations: Array<{
+            opIndex?: number;
+            name: string;
+            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version: number;
+            dataHash: string;
+            status?: 'applied' | '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;
+                }>;
+            };
+        } | {
+            opIndex?: number;
+            name: string;
+            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version?: number;
+            dataHash?: string;
+            status?: 'success' | 'noop' | 'failed';
+            error?: {
+                code: string;
+                message: string;
+                details?: {
+                    reason: 'expected_version_mismatch';
+                    expectedVersion: number;
+                    currentVersion: number;
+                } | {
+                    reason: 'lease_held';
+                    leaseExpiresAt: string;
+                } | {
+                    reason: 'validation_failed';
+                    issues: Array<{
+                        path: string;
+                        message: string;
+                    }>;
+                } | {
+                    reason: 'rate_limit_reset';
+                    retryAfterSeconds: number;
+                    resetAt: string;
+                } | {
+                    reason: 'cursor_fence_unavailable';
+                    cause: 'not_ready' | 'below_floor' | 'above_head';
+                    retryFromStart: true;
+                };
+            };
+            resolvedName?: string;
+            retryable?: boolean;
+            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;
+                }>;
+            };
+        }>;
+        outcome: 'event' | 'no_event';
+        requestDigest: string;
+        schemaVersion: 'operation-event-receipt/v1';
+        submissionId?: string;
+    }>;
 };
 type CredentialDeleteResult$1 = {
     ok: true;
@@ -530,6 +580,8 @@ type CredentialRevokeResult$1 = {
 type Capabilities = {
     apiVersion: string;
     minSupportedSdk: string;
+    minSupportedClients: Record<string, string>;
+    writeContractVersion: number;
     features: Record<string, boolean>;
 };
 type HomepageFeaturedListsResult$1 = {
@@ -568,93 +620,1144 @@ type HomepageFeaturedListsResult$1 = {
                 assertion: number;
             };
         }>;
-    }>;
+    }>;
+};
+type StreamAppendInput$1 = {
+    orgName: string;
+    repoName: string;
+    streamId: string;
+    componentRef?: string;
+    workspaceName?: never;
+    committer?: string;
+    message?: string;
+    returnRepoSeq?: boolean;
+    allocatedTokens?: never;
+    allocatedTokenRanges: Array<{
+        start: number;
+        end: number;
+    }>;
+    operations: Array<{
+        operation: 'add';
+        kind: 'shape';
+        name: string;
+        data: unknown;
+        skipExisting?: boolean;
+    } | {
+        operation: 'add';
+        kind: 'thing';
+        name: string;
+        data: unknown;
+        skipExisting?: boolean;
+    } | {
+        operation: 'add';
+        kind: 'assertion';
+        name: string;
+        about: string;
+        data: unknown;
+        skipExisting?: boolean;
+    } | {
+        operation: 'add';
+        kind: 'collection';
+        name: string;
+        type: 'arc' | 'bond' | 'pair' | 'set' | 'list';
+        members: Array<string>;
+        skipExisting?: boolean;
+    } | {
+        operation: 'revise';
+        kind: 'shape';
+        name: string;
+        data: unknown;
+        expectedVersion?: number;
+        active?: never;
+        leaseId?: string;
+    } | {
+        operation: 'revise';
+        kind: 'thing';
+        name: string;
+        data: unknown;
+        expectedVersion?: number;
+        active?: never;
+        leaseId?: string;
+    } | {
+        operation: 'revise';
+        kind: 'assertion';
+        name: string;
+        data: unknown;
+        expectedVersion?: number;
+        active?: never;
+        leaseId?: string;
+    } | {
+        operation: 'revise';
+        kind: 'collection';
+        name: string;
+        type: 'arc' | 'bond' | 'pair' | 'set' | 'list';
+        members: Array<string>;
+        expectedVersion?: number;
+        leaseId?: string;
+    } | {
+        operation: 'retract';
+        name: string;
+        kind?: 'shape' | 'thing' | 'assertion' | 'collection';
+        reason?: string;
+        expectedVersion?: number;
+        leaseId?: string;
+    } | {
+        operation: 'rename';
+        name: string;
+        newName: string;
+        kind?: 'shape' | 'thing' | 'assertion' | 'collection';
+    }>;
+    chunkOrdinal: number;
+    submissionId: string;
+};
+type StreamAppendResult$1 = {
+    allocatedTokenRanges: Array<{
+        start: number;
+        end: number;
+    }>;
+    results: Array<{
+        opIndex?: number;
+        name: string;
+        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        version?: number;
+        dataHash?: string;
+        status?: 'success' | 'noop' | 'failed';
+        error?: {
+            code: string;
+            message: string;
+            details?: {
+                reason: 'expected_version_mismatch';
+                expectedVersion: number;
+                currentVersion: number;
+            } | {
+                reason: 'lease_held';
+                leaseExpiresAt: string;
+            } | {
+                reason: 'validation_failed';
+                issues: Array<{
+                    path: string;
+                    message: string;
+                }>;
+            } | {
+                reason: 'rate_limit_reset';
+                retryAfterSeconds: number;
+                resetAt: string;
+            } | {
+                reason: 'cursor_fence_unavailable';
+                cause: 'not_ready' | 'below_floor' | 'above_head';
+                retryFromStart: true;
+            };
+        };
+        resolvedName?: string;
+        retryable?: boolean;
+        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;
+            }>;
+        };
+    }>;
+    repoSeq?: number;
+    createdByEmail?: string;
+    appendTotalMs?: number;
+    appendResolveRepoMs?: number;
+    appendTokenResolveMs?: number;
+    appendApplyMs?: number;
+    applySubphases?: {
+        addThingMs?: number;
+        addAssertionMs?: number;
+        addAssertionResolveAboutMs?: number;
+        reviseThingMs?: number;
+        reviseAssertionMs?: number;
+        reviseCollectionMs?: number;
+        preparePinnedLoadShapeFieldsMs?: number;
+        preparePinnedPinWrefsMs?: number;
+        preparePinnedResolveTokensMs?: number;
+        preparePinnedValidateMs?: number;
+        operationLoopMs?: number;
+        persistMs?: number;
+        persistThingsMs?: number;
+        persistVersionsMs?: number;
+        persistAssertionsMs?: number;
+        persistUpdatesMs?: number;
+        persistOutboxMs?: number;
+        refInsertMs?: number;
+        refSourceCount?: number;
+    };
+    event: {
+        committedAt: string;
+        eventDigest: string;
+        operationCount: number;
+        repo: {
+            orgName: string;
+            repoName: string;
+        };
+        repoSeq: string;
+    } | null;
+    eventRequestId: string;
+    operations: Array<{
+        opIndex?: number;
+        name: string;
+        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        version: number;
+        dataHash: string;
+        status?: 'applied' | '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;
+            }>;
+        };
+    } | {
+        opIndex?: number;
+        name: string;
+        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        version?: number;
+        dataHash?: string;
+        status?: 'success' | 'noop' | 'failed';
+        error?: {
+            code: string;
+            message: string;
+            details?: {
+                reason: 'expected_version_mismatch';
+                expectedVersion: number;
+                currentVersion: number;
+            } | {
+                reason: 'lease_held';
+                leaseExpiresAt: string;
+            } | {
+                reason: 'validation_failed';
+                issues: Array<{
+                    path: string;
+                    message: string;
+                }>;
+            } | {
+                reason: 'rate_limit_reset';
+                retryAfterSeconds: number;
+                resetAt: string;
+            } | {
+                reason: 'cursor_fence_unavailable';
+                cause: 'not_ready' | 'below_floor' | 'above_head';
+                retryFromStart: true;
+            };
+        };
+        resolvedName?: string;
+        retryable?: boolean;
+        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;
+            }>;
+        };
+    }>;
+    outcome: 'event' | 'no_event';
+    requestDigest: string;
+    schemaVersion: 'operation-event-receipt/v1';
+    submissionId?: string;
+    receipt: {
+        event: {
+            committedAt: string;
+            eventDigest: string;
+            operationCount: number;
+            repo: {
+                orgName: string;
+                repoName: string;
+            };
+            repoSeq: string;
+        } | null;
+        eventRequestId: string;
+        operations: Array<{
+            opIndex?: number;
+            name: string;
+            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version: number;
+            dataHash: string;
+            status?: 'applied' | '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;
+                }>;
+            };
+        } | {
+            opIndex?: number;
+            name: string;
+            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version?: number;
+            dataHash?: string;
+            status?: 'success' | 'noop' | 'failed';
+            error?: {
+                code: string;
+                message: string;
+                details?: {
+                    reason: 'expected_version_mismatch';
+                    expectedVersion: number;
+                    currentVersion: number;
+                } | {
+                    reason: 'lease_held';
+                    leaseExpiresAt: string;
+                } | {
+                    reason: 'validation_failed';
+                    issues: Array<{
+                        path: string;
+                        message: string;
+                    }>;
+                } | {
+                    reason: 'rate_limit_reset';
+                    retryAfterSeconds: number;
+                    resetAt: string;
+                } | {
+                    reason: 'cursor_fence_unavailable';
+                    cause: 'not_ready' | 'below_floor' | 'above_head';
+                    retryFromStart: true;
+                };
+            };
+            resolvedName?: string;
+            retryable?: boolean;
+            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;
+                }>;
+            };
+        }>;
+        outcome: 'event' | 'no_event';
+        requestDigest: string;
+        schemaVersion: 'operation-event-receipt/v1';
+        submissionId?: string;
+    };
+};
+type CommitApplyCompatibilityResult$1 = {
+    committer?: string;
+    createdByEmail?: string;
+    message?: string;
+    operationCount: number;
+    repoSeq?: number;
+    operations: Array<{
+        opIndex?: number;
+        name: string;
+        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        version: number;
+        dataHash: string;
+        status?: 'applied' | '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;
+            }>;
+        };
+    }>;
+    event: {
+        committedAt: string;
+        eventDigest: string;
+        operationCount: number;
+        repo: {
+            orgName: string;
+            repoName: string;
+        };
+        repoSeq: string;
+    } | null;
+    eventRequestId: string;
+    outcome: 'event' | 'no_event';
+    requestDigest: string;
+    schemaVersion: 'operation-event-receipt/v1';
+    submissionId?: string;
+    receipt: {
+        event: {
+            committedAt: string;
+            eventDigest: string;
+            operationCount: number;
+            repo: {
+                orgName: string;
+                repoName: string;
+            };
+            repoSeq: string;
+        } | null;
+        eventRequestId: string;
+        operations: Array<{
+            opIndex?: number;
+            name: string;
+            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version: number;
+            dataHash: string;
+            status?: 'applied' | '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;
+                }>;
+            };
+        } | {
+            opIndex?: number;
+            name: string;
+            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version?: number;
+            dataHash?: string;
+            status?: 'success' | 'noop' | 'failed';
+            error?: {
+                code: string;
+                message: string;
+                details?: {
+                    reason: 'expected_version_mismatch';
+                    expectedVersion: number;
+                    currentVersion: number;
+                } | {
+                    reason: 'lease_held';
+                    leaseExpiresAt: string;
+                } | {
+                    reason: 'validation_failed';
+                    issues: Array<{
+                        path: string;
+                        message: string;
+                    }>;
+                } | {
+                    reason: 'rate_limit_reset';
+                    retryAfterSeconds: number;
+                    resetAt: string;
+                } | {
+                    reason: 'cursor_fence_unavailable';
+                    cause: 'not_ready' | 'below_floor' | 'above_head';
+                    retryFromStart: true;
+                };
+            };
+            resolvedName?: string;
+            retryable?: boolean;
+            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;
+                }>;
+            };
+        }>;
+        outcome: 'event' | 'no_event';
+        requestDigest: string;
+        schemaVersion: 'operation-event-receipt/v1';
+        submissionId?: string;
+    };
+};
+type CollectionMutationCompatibilityResult = {
+    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;
+        }>;
+    };
+    event: {
+        committedAt: string;
+        eventDigest: string;
+        operationCount: number;
+        repo: {
+            orgName: string;
+            repoName: string;
+        };
+        repoSeq: string;
+    } | null;
+    eventRequestId: string;
+    operations: Array<{
+        opIndex?: number;
+        name: string;
+        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        version: number;
+        dataHash: string;
+        status?: 'applied' | '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;
+            }>;
+        };
+    } | {
+        opIndex?: number;
+        name: string;
+        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        version?: number;
+        dataHash?: string;
+        status?: 'success' | 'noop' | 'failed';
+        error?: {
+            code: string;
+            message: string;
+            details?: {
+                reason: 'expected_version_mismatch';
+                expectedVersion: number;
+                currentVersion: number;
+            } | {
+                reason: 'lease_held';
+                leaseExpiresAt: string;
+            } | {
+                reason: 'validation_failed';
+                issues: Array<{
+                    path: string;
+                    message: string;
+                }>;
+            } | {
+                reason: 'rate_limit_reset';
+                retryAfterSeconds: number;
+                resetAt: string;
+            } | {
+                reason: 'cursor_fence_unavailable';
+                cause: 'not_ready' | 'below_floor' | 'above_head';
+                retryFromStart: true;
+            };
+        };
+        resolvedName?: string;
+        retryable?: boolean;
+        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;
+            }>;
+        };
+    }>;
+    outcome: 'event' | 'no_event';
+    requestDigest: string;
+    schemaVersion: 'operation-event-receipt/v1';
+    submissionId?: string;
+    receipt: {
+        event: {
+            committedAt: string;
+            eventDigest: string;
+            operationCount: number;
+            repo: {
+                orgName: string;
+                repoName: string;
+            };
+            repoSeq: string;
+        } | null;
+        eventRequestId: string;
+        operations: Array<{
+            opIndex?: number;
+            name: string;
+            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version: number;
+            dataHash: string;
+            status?: 'applied' | '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;
+                }>;
+            };
+        } | {
+            opIndex?: number;
+            name: string;
+            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version?: number;
+            dataHash?: string;
+            status?: 'success' | 'noop' | 'failed';
+            error?: {
+                code: string;
+                message: string;
+                details?: {
+                    reason: 'expected_version_mismatch';
+                    expectedVersion: number;
+                    currentVersion: number;
+                } | {
+                    reason: 'lease_held';
+                    leaseExpiresAt: string;
+                } | {
+                    reason: 'validation_failed';
+                    issues: Array<{
+                        path: string;
+                        message: string;
+                    }>;
+                } | {
+                    reason: 'rate_limit_reset';
+                    retryAfterSeconds: number;
+                    resetAt: string;
+                } | {
+                    reason: 'cursor_fence_unavailable';
+                    cause: 'not_ready' | 'below_floor' | 'above_head';
+                    retryFromStart: true;
+                };
+            };
+            resolvedName?: string;
+            retryable?: boolean;
+            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;
+                }>;
+            };
+        }>;
+        outcome: 'event' | 'no_event';
+        requestDigest: string;
+        schemaVersion: 'operation-event-receipt/v1';
+        submissionId?: string;
+    };
+};
+type RenameCompatibilityResult = {
+    renamed: true;
+    event: {
+        committedAt: string;
+        eventDigest: string;
+        operationCount: number;
+        repo: {
+            orgName: string;
+            repoName: string;
+        };
+        repoSeq: string;
+    } | null;
+    eventRequestId: string;
+    operations: Array<{
+        opIndex?: number;
+        name: string;
+        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        version: number;
+        dataHash: string;
+        status?: 'applied' | '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;
+            }>;
+        };
+    } | {
+        opIndex?: number;
+        name: string;
+        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        version?: number;
+        dataHash?: string;
+        status?: 'success' | 'noop' | 'failed';
+        error?: {
+            code: string;
+            message: string;
+            details?: {
+                reason: 'expected_version_mismatch';
+                expectedVersion: number;
+                currentVersion: number;
+            } | {
+                reason: 'lease_held';
+                leaseExpiresAt: string;
+            } | {
+                reason: 'validation_failed';
+                issues: Array<{
+                    path: string;
+                    message: string;
+                }>;
+            } | {
+                reason: 'rate_limit_reset';
+                retryAfterSeconds: number;
+                resetAt: string;
+            } | {
+                reason: 'cursor_fence_unavailable';
+                cause: 'not_ready' | 'below_floor' | 'above_head';
+                retryFromStart: true;
+            };
+        };
+        resolvedName?: string;
+        retryable?: boolean;
+        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;
+            }>;
+        };
+    }>;
+    outcome: 'event' | 'no_event';
+    requestDigest: string;
+    schemaVersion: 'operation-event-receipt/v1';
+    submissionId?: string;
+    receipt: {
+        event: {
+            committedAt: string;
+            eventDigest: string;
+            operationCount: number;
+            repo: {
+                orgName: string;
+                repoName: string;
+            };
+            repoSeq: string;
+        } | null;
+        eventRequestId: string;
+        operations: Array<{
+            opIndex?: number;
+            name: string;
+            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version: number;
+            dataHash: string;
+            status?: 'applied' | '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;
+                }>;
+            };
+        } | {
+            opIndex?: number;
+            name: string;
+            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version?: number;
+            dataHash?: string;
+            status?: 'success' | 'noop' | 'failed';
+            error?: {
+                code: string;
+                message: string;
+                details?: {
+                    reason: 'expected_version_mismatch';
+                    expectedVersion: number;
+                    currentVersion: number;
+                } | {
+                    reason: 'lease_held';
+                    leaseExpiresAt: string;
+                } | {
+                    reason: 'validation_failed';
+                    issues: Array<{
+                        path: string;
+                        message: string;
+                    }>;
+                } | {
+                    reason: 'rate_limit_reset';
+                    retryAfterSeconds: number;
+                    resetAt: string;
+                } | {
+                    reason: 'cursor_fence_unavailable';
+                    cause: 'not_ready' | 'below_floor' | 'above_head';
+                    retryFromStart: true;
+                };
+            };
+            resolvedName?: string;
+            retryable?: boolean;
+            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;
+                }>;
+            };
+        }>;
+        outcome: 'event' | 'no_event';
+        requestDigest: string;
+        schemaVersion: 'operation-event-receipt/v1';
+        submissionId?: string;
+    };
+};
+type ShapeChangeCompatibilityResult = {
+    name: string;
+    operation: 'add' | 'revise' | 'retract' | 'noop';
+    version: number;
+    dataHash: string;
+    event: {
+        committedAt: string;
+        eventDigest: string;
+        operationCount: number;
+        repo: {
+            orgName: string;
+            repoName: string;
+        };
+        repoSeq: string;
+    } | null;
+    eventRequestId: string;
+    operations: Array<{
+        opIndex?: number;
+        name: string;
+        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        version: number;
+        dataHash: string;
+        status?: 'applied' | '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;
+            }>;
+        };
+    } | {
+        opIndex?: number;
+        name: string;
+        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        version?: number;
+        dataHash?: string;
+        status?: 'success' | 'noop' | 'failed';
+        error?: {
+            code: string;
+            message: string;
+            details?: {
+                reason: 'expected_version_mismatch';
+                expectedVersion: number;
+                currentVersion: number;
+            } | {
+                reason: 'lease_held';
+                leaseExpiresAt: string;
+            } | {
+                reason: 'validation_failed';
+                issues: Array<{
+                    path: string;
+                    message: string;
+                }>;
+            } | {
+                reason: 'rate_limit_reset';
+                retryAfterSeconds: number;
+                resetAt: string;
+            } | {
+                reason: 'cursor_fence_unavailable';
+                cause: 'not_ready' | 'below_floor' | 'above_head';
+                retryFromStart: true;
+            };
+        };
+        resolvedName?: string;
+        retryable?: boolean;
+        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;
+            }>;
+        };
+    }>;
+    outcome: 'event' | 'no_event';
+    requestDigest: string;
+    schemaVersion: 'operation-event-receipt/v1';
+    submissionId?: string;
+    receipt: {
+        event: {
+            committedAt: string;
+            eventDigest: string;
+            operationCount: number;
+            repo: {
+                orgName: string;
+                repoName: string;
+            };
+            repoSeq: string;
+        } | null;
+        eventRequestId: string;
+        operations: Array<{
+            opIndex?: number;
+            name: string;
+            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version: number;
+            dataHash: string;
+            status?: 'applied' | '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;
+                }>;
+            };
+        } | {
+            opIndex?: number;
+            name: string;
+            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version?: number;
+            dataHash?: string;
+            status?: 'success' | 'noop' | 'failed';
+            error?: {
+                code: string;
+                message: string;
+                details?: {
+                    reason: 'expected_version_mismatch';
+                    expectedVersion: number;
+                    currentVersion: number;
+                } | {
+                    reason: 'lease_held';
+                    leaseExpiresAt: string;
+                } | {
+                    reason: 'validation_failed';
+                    issues: Array<{
+                        path: string;
+                        message: string;
+                    }>;
+                } | {
+                    reason: 'rate_limit_reset';
+                    retryAfterSeconds: number;
+                    resetAt: string;
+                } | {
+                    reason: 'cursor_fence_unavailable';
+                    cause: 'not_ready' | 'below_floor' | 'above_head';
+                    retryFromStart: true;
+                };
+            };
+            resolvedName?: string;
+            retryable?: boolean;
+            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;
+                }>;
+            };
+        }>;
+        outcome: 'event' | 'no_event';
+        requestDigest: string;
+        schemaVersion: 'operation-event-receipt/v1';
+        submissionId?: string;
+    };
 };
-type StreamAppendInput$1 = {
-    orgName: string;
-    repoName: string;
-    streamId: string;
-    componentRef?: string;
-    workspaceName?: never;
-    committer?: string;
-    message?: string;
-    returnRepoSeq?: boolean;
-    allocatedTokens?: never;
-    allocatedTokenRanges: [];
+type ShapeRemoveCompatibilityResult = {
+    name: string;
+    operation: 'add' | 'revise' | 'retract' | 'noop';
+    version: number;
+    dataHash: string;
+    removed: true;
+    event: {
+        committedAt: string;
+        eventDigest: string;
+        operationCount: number;
+        repo: {
+            orgName: string;
+            repoName: string;
+        };
+        repoSeq: string;
+    } | null;
+    eventRequestId: string;
     operations: Array<{
-        operation: 'add';
-        kind: 'shape';
-        name: string;
-        data: unknown;
-        skipExisting?: boolean;
-    } | {
-        operation: 'add';
-        kind: 'thing';
-        name: string;
-        data: unknown;
-        skipExisting?: boolean;
-    } | {
-        operation: 'add';
-        kind: 'assertion';
-        name: string;
-        about: string;
-        data: unknown;
-        skipExisting?: boolean;
-    } | {
-        operation: 'add';
-        kind: 'collection';
-        name: string;
-        type: 'arc' | 'bond' | 'pair' | 'set' | 'list';
-        members: Array<string>;
-        skipExisting?: boolean;
-    } | {
-        operation: 'revise';
-        kind: 'shape';
-        name: string;
-        data: unknown;
-        expectedVersion?: number;
-        active?: never;
-        leaseId?: string;
-    } | {
-        operation: 'revise';
-        kind: 'thing';
-        name: string;
-        data: unknown;
-        expectedVersion?: number;
-        active?: never;
-        leaseId?: string;
-    } | {
-        operation: 'revise';
-        kind: 'assertion';
-        name: string;
-        data: unknown;
-        expectedVersion?: number;
-        active?: never;
-        leaseId?: string;
-    } | {
-        operation: 'revise';
-        kind: 'collection';
-        name: string;
-        type: 'arc' | 'bond' | 'pair' | 'set' | 'list';
-        members: Array<string>;
-        expectedVersion?: number;
-        leaseId?: string;
-    } | {
-        operation: 'retract';
+        opIndex?: number;
         name: string;
-        kind?: 'shape' | 'thing' | 'assertion' | 'collection';
-        reason?: string;
-        leaseId?: string;
+        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+        version: number;
+        dataHash: string;
+        status?: 'applied' | '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;
+            }>;
+        };
     } | {
-        operation: 'rename';
-        name: string;
-        newName: string;
-        kind?: 'shape' | 'thing' | 'assertion' | 'collection';
-    }>;
-};
-type StreamAppendResult$1 = {
-    allocatedTokenRanges: [];
-    results: Array<{
         opIndex?: number;
         name: string;
         operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
@@ -707,32 +1810,103 @@ type StreamAppendResult$1 = {
             }>;
         };
     }>;
-    repoSeq?: number;
-    createdByEmail?: string;
-    appendTotalMs?: number;
-    appendResolveRepoMs?: number;
-    appendTokenResolveMs?: number;
-    appendApplyMs?: number;
-    applySubphases?: {
-        addThingMs?: number;
-        addAssertionMs?: number;
-        addAssertionResolveAboutMs?: number;
-        reviseThingMs?: number;
-        reviseAssertionMs?: number;
-        reviseCollectionMs?: number;
-        preparePinnedLoadShapeFieldsMs?: number;
-        preparePinnedPinWrefsMs?: number;
-        preparePinnedResolveTokensMs?: number;
-        preparePinnedValidateMs?: number;
-        operationLoopMs?: number;
-        persistMs?: number;
-        persistThingsMs?: number;
-        persistVersionsMs?: number;
-        persistAssertionsMs?: number;
-        persistUpdatesMs?: number;
-        persistOutboxMs?: number;
-        refInsertMs?: number;
-        refSourceCount?: number;
+    outcome: 'event' | 'no_event';
+    requestDigest: string;
+    schemaVersion: 'operation-event-receipt/v1';
+    submissionId?: string;
+    receipt: {
+        event: {
+            committedAt: string;
+            eventDigest: string;
+            operationCount: number;
+            repo: {
+                orgName: string;
+                repoName: string;
+            };
+            repoSeq: string;
+        } | null;
+        eventRequestId: string;
+        operations: Array<{
+            opIndex?: number;
+            name: string;
+            operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version: number;
+            dataHash: string;
+            status?: 'applied' | '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;
+                }>;
+            };
+        } | {
+            opIndex?: number;
+            name: string;
+            operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
+            version?: number;
+            dataHash?: string;
+            status?: 'success' | 'noop' | 'failed';
+            error?: {
+                code: string;
+                message: string;
+                details?: {
+                    reason: 'expected_version_mismatch';
+                    expectedVersion: number;
+                    currentVersion: number;
+                } | {
+                    reason: 'lease_held';
+                    leaseExpiresAt: string;
+                } | {
+                    reason: 'validation_failed';
+                    issues: Array<{
+                        path: string;
+                        message: string;
+                    }>;
+                } | {
+                    reason: 'rate_limit_reset';
+                    retryAfterSeconds: number;
+                    resetAt: string;
+                } | {
+                    reason: 'cursor_fence_unavailable';
+                    cause: 'not_ready' | 'below_floor' | 'above_head';
+                    retryFromStart: true;
+                };
+            };
+            resolvedName?: string;
+            retryable?: boolean;
+            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;
+                }>;
+            };
+        }>;
+        outcome: 'event' | 'no_event';
+        requestDigest: string;
+        schemaVersion: 'operation-event-receipt/v1';
+        submissionId?: string;
     };
 };
 type Org = {
@@ -878,8 +2052,111 @@ type ThingHeadVersionsResult$1 = {
     }>;
     missing: Array<string>;
 };
-type RenameResult$1 = {
-    renamed: true;
+type RepositoryCheckpointAccess$1 = {
+    checkpointId: string;
+    repoSeq: number;
+    expiresAt: number;
+    url: string;
+    byteLength: number;
+    sha256: string;
+    contentType: 'application/zip' | 'application/json' | 'application/x-ndjson';
+};
+type RepositoryCheckpointStatus$1 = {
+    checkpointId: string;
+    repoSeq: number;
+    contractVersion: 1;
+    attemptsStarted: number;
+    runAgeMs: number;
+    createdAt: number;
+    updatedAt: number;
+    runStartedAt: number;
+    state: 'queued';
+    nextAction: 'poll';
+} | {
+    checkpointId: string;
+    repoSeq: number;
+    contractVersion: 1;
+    attemptsStarted: number;
+    runAgeMs: number;
+    createdAt: number;
+    updatedAt: number;
+    runStartedAt: number;
+    state: 'running';
+    nextAction: 'poll';
+} | {
+    checkpointId: string;
+    repoSeq: number;
+    contractVersion: 1;
+    attemptsStarted: number;
+    runAgeMs: number;
+    createdAt: number;
+    updatedAt: number;
+    runStartedAt: number;
+    state: 'complete';
+    nextAction: 'download';
+    completedAt: number;
+    recordCount: number;
+    manifest: {
+        byteLength: number;
+        sha256: string;
+    };
+    archive: {
+        byteLength: number;
+        sha256: string;
+        contentType: 'application/zip';
+    };
+} | {
+    checkpointId: string;
+    repoSeq: number;
+    contractVersion: 1;
+    attemptsStarted: number;
+    runAgeMs: number;
+    createdAt: number;
+    updatedAt: number;
+    runStartedAt: number;
+    state: 'failed';
+    completedAt: number;
+    failureCode: 'deadline_exceeded';
+    nextAction: 'retry';
+} | {
+    checkpointId: string;
+    repoSeq: number;
+    contractVersion: 1;
+    attemptsStarted: number;
+    runAgeMs: number;
+    createdAt: number;
+    updatedAt: number;
+    runStartedAt: number;
+    state: 'failed';
+    completedAt: number;
+    failureCode: 'invalid_source';
+    nextAction: 'generate';
+} | {
+    checkpointId: string;
+    repoSeq: number;
+    contractVersion: 1;
+    attemptsStarted: number;
+    runAgeMs: number;
+    createdAt: number;
+    updatedAt: number;
+    runStartedAt: number;
+    state: 'failed';
+    completedAt: number;
+    failureCode: 'canonicalization_failed' | 'integrity_failed' | 'unsupported_contract';
+    nextAction: 'contact_support';
+} | {
+    checkpointId: string;
+    repoSeq: number;
+    contractVersion: 1;
+    attemptsStarted: number;
+    runAgeMs: number;
+    createdAt: number;
+    updatedAt: number;
+    runStartedAt: number;
+    state: 'failed';
+    completedAt: number;
+    failureCode: 'repository_deleted';
+    nextAction: 'none';
 };
 type RepoConfigureStats = {
     subscriptionCount: number;
@@ -1059,19 +2336,6 @@ type SynthesizedRepoContent$1 = {
         };
     };
 };
-type ShapeChangeResult = {
-    name: string;
-    operation: 'add' | 'revise' | 'retract' | 'noop';
-    version: number;
-    dataHash: string;
-};
-type ShapeRemoveResult = {
-    name: string;
-    operation: 'add' | 'revise' | 'retract' | 'noop';
-    version: number;
-    dataHash: string;
-    removed: true;
-};
 type SubscriptionBindCredentialsResult$1 = {
     bound: true;
     subscriptionName: string;
@@ -1112,12 +2376,219 @@ type TokenCreateResult = {
 type TokenRevokeResult = {
     ok: boolean;
 };
-type WireScopeEntry$1 = {
-    resource?: string;
-    permissions: Array<string>;
-    allowedMatches?: Array<string>;
+type WireScopeEntry$1 = {
+    resource?: string;
+    permissions: Array<string>;
+    allowedMatches?: Array<string>;
+};
+
+type DateMappedRepositoryCheckpointStatus<T> = T extends {
+    createdAt: number;
+    updatedAt: number;
+    runStartedAt: number;
+} ? Omit<T, 'createdAt' | 'updatedAt' | 'runStartedAt' | 'completedAt'> & {
+    createdAt: Date;
+    updatedAt: Date;
+    runStartedAt: Date;
+} & (T extends {
+    completedAt: number;
+} ? {
+    completedAt: Date;
+} : object) : never;
+/**
+ * The current lifecycle state of a repository checkpoint.
+ *
+ * Checkpoint timestamps are converted from Unix milliseconds to `Date`; the
+ * server-computed `runAgeMs` remains numeric.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/repositorycheckpointstatus/
+ */
+type RepositoryCheckpointStatus = DateMappedRepositoryCheckpointStatus<RepositoryCheckpointStatus$1>;
+/**
+ * A short-lived descriptor for downloading one completed checkpoint artifact.
+ * The SDK returns this descriptor only; it never fetches `url` on the caller's
+ * behalf.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/repositorycheckpointaccess/
+ */
+type RepositoryCheckpointAccess = Omit<RepositoryCheckpointAccess$1, 'expiresAt'> & {
+    expiresAt: Date;
+};
+
+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];
+
+/**
+ * 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";
+/**
+ * HMAC signature header used by component CLI dispatch.
+ * @see https://docs.warmhub.ai/sdk-reference/variables/cli_signature_header/
+ */
+declare const CLI_SIGNATURE_HEADER = "X-WarmHub-Signature";
+/**
+ * Unix-seconds timestamp header used by component CLI dispatch.
+ * @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';
+
+/** Every event type a webhook subscription can watch. */
+declare const SUBSCRIBABLE_EVENT_TYPES: readonly ["commit", "repo.renamed", "org.renamed", "org.member_added", "org.repo_created", "org.repo_published", "thing.renamed", "shape.renamed"];
+type SubscribableEventType = (typeof SUBSCRIBABLE_EVENT_TYPES)[number];
+/** Org-scoped events — created with an `orgName` and no `repoName`. */
+declare const ORG_SCOPED_EVENT_TYPES: readonly ["org.renamed", "org.member_added", "org.repo_created", "org.repo_published"];
+type OrgScopedEventType = (typeof ORG_SCOPED_EVENT_TYPES)[number];
+
+/**
+ * Validate a data payload against shape field definitions.
+ *
+ * Shape field types:
+ * - "number", "string", "boolean": primitive types
+ * - "wref": string (reference to a shape or shaped thing)
+ * - Typed field objects: { type: primitive, description?: string }
+ * - Nested objects: { fieldName: type, ... }
+ * - Arrays: [elementType]
+ * - Optional fields: field name ending with "?" (e.g. "terminal_reason?": "string")
+ *   OR type string ending with "?" (e.g. "terminal_reason": "string?")
+ *   OR typed object type ending with "?" (e.g. { type: "string?" })
+ *
+ * For v1 this is permissive: validates top-level field existence and basic types.
+ * Returns a {@link ShapeValidatorResult} discriminated union — read `result.valid`
+ * to branch, then `result.errors` (only present when invalid) for the list of
+ * messages. `result.warnings` may be present in either branch and carries
+ * undeclared top-level field names.
+ *
+ * @example
+ * ```ts
+ * import { validateAgainstShape } from "@warmhub/sdk-ts";
+ *
+ * const shapeFields = { x: "number", y: "number", label: "string?" };
+ *
+ * const ok = validateAgainstShape({ x: 1, y: 2 }, shapeFields);
+ * // ok.valid === true
+ *
+ * const bad = validateAgainstShape({ x: "not-a-number" }, shapeFields);
+ * if (!bad.valid) {
+ *   for (const message of bad.errors) console.error(message);
+ *   // ['Field "x" must be a number', 'Missing required field: "y"']
+ * }
+ * ```
+ * @see https://docs.warmhub.ai/sdk-reference/functions/validateagainstshape/
+ */
+declare function validateAgainstShape(data: Record<string, unknown>, shapeFields: Record<string, unknown>): ShapeValidatorResult;
+/**
+ * Warning details for input fields that the shape does not declare.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/undeclaredfieldswarning/
+ */
+type UndeclaredFieldsWarning = {
+    undeclaredFields: string[];
+    undeclaredFieldsTruncated?: true;
+    totalUndeclared?: number;
+};
+/**
+ * Discriminated result returned when input is validated against shape fields.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/shapevalidatorresult/
+ */
+type ShapeValidatorResult = {
+    valid: true;
+    warnings?: UndeclaredFieldsWarning;
+} | {
+    valid: false;
+    errors: string[];
+    warnings?: UndeclaredFieldsWarning;
 };
 
+/**
+ * Hardcoded meta-schema for validating shape definitions.
+ * Shapes are NOT validated against a DB-stored shape — they validate against this constant.
+ * This avoids the bootstrap chicken-and-egg problem.
+ *
+ * A valid shape definition is:
+ * { fields: Record<string, TypeSpec>, description?: string }
+ * where TypeSpec is one of:
+ *   - primitive string: "number", "string", "boolean", "wref", "array"
+ *   - optional primitive: "number?", "string?", "boolean?", "wref?", "array?"
+ *   - typed field object: { type: primitive, description?: string }
+ *   - array: [TypeSpec] (shorthand) or { type: "array", items: TypeSpec }
+ *   - nested object: { fieldName: TypeSpec, ... } (key may end with "?" for optional)
+ *
+ * The primitive vocabulary above is closed: any other type name (e.g. "text",
+ * "integer", "json", "date") is rejected. See VALID_PRIMITIVE_TYPES in
+ * ./shape-types.ts for the authoritative set.
+ * String `pattern` constraints use RE2 syntax and are evaluated with re2js so
+ * user-authored patterns run in linear time across backend, SDK, web, CLI, and
+ * worker-adjacent consumers. JavaScript-only constructs such as backreferences
+ * and lookarounds are rejected at shape-definition time.
+ */
+
+/**
+ * Maximum size, in bytes (UTF-8 encoded), allowed for a single content field value.
+ * WarmHub is not a document store: values larger than this are rejected at validation.
+ * Store large documents in S3, Box, Drive, or another document system and reference
+ * them from WarmHub instead.
+ * @see https://docs.warmhub.ai/sdk-reference/variables/max_content_field_bytes/
+ */
+declare const MAX_CONTENT_FIELD_BYTES: number;
+/**
+ * Human-readable explanation of the {@link MAX_CONTENT_FIELD_BYTES} limit, suitable for
+ * appending to a field-specific validation error. States the byte cap and points callers
+ * to an external document store for large payloads.
+ * @see https://docs.warmhub.ai/sdk-reference/variables/content_field_limit_error/
+ */
+declare const CONTENT_FIELD_LIMIT_ERROR: string;
+/**
+ * Returns a validation error message if the given string exceeds
+ * {@link MAX_CONTENT_FIELD_BYTES} when UTF-8 encoded, or `null` if it is within the limit.
+ *
+ * @param path - The field path, used to identify the offending field in the message.
+ * @param value - The candidate field value to measure.
+ * @see https://docs.warmhub.ai/sdk-reference/functions/contentfieldlimiterror/
+ */
+declare function contentFieldLimitError(path: string, value: string): string | null;
+
 /**
  * Add operation accepted by `client.commit.apply`. Use this shape to create new
  * shapes, things, assertions, or collections in a single commit.
@@ -1250,6 +2721,11 @@ interface RetractOperation {
      * Optional human-readable retraction reason.
      */
     reason?: string;
+    /**
+     * Optional optimistic-concurrency precondition. When supplied, the retract
+     * is applied only if the target is still at this version number.
+     */
+    expectedVersion?: number;
     /**
      * Optional read-lease token (#3625) returned by `thing.getWithLease`. A
      * matching token auto-releases the lease on commit; a mismatch (or absence
@@ -1335,16 +2811,12 @@ interface OperationStreamClient {
         append(input: StreamAppendInput$1): Promise<StreamAppendResult$1>;
     };
 }
+/** Legacy aggregate write result with exact chunk receipts added alongside it. */
 type SubmittedStreamResult = {
     committer?: string;
     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?: {
@@ -1367,13 +2839,10 @@ type SubmittedStreamResult = {
         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
-         * the backend's `streamMutationResultEntrySchema.warnings`.
-         */
         warnings?: NonNullable<StreamAppendResult$1['results'][number]['warnings']>;
     }>;
+    /** One exact immutable receipt per stream chunk, in submission order. */
+    receipts: OperationEventReceiptV1$1[];
 };
 /**
  * Stream identity metadata for caller-managed streamed commit submissions.
@@ -1381,11 +2850,12 @@ type SubmittedStreamResult = {
  */
 type StreamContinuationState = {
     streamId: string;
-    allocatedTokenRanges: StreamAppendResult$1['allocatedTokenRanges'];
+    submissionId: string;
+    nextChunkOrdinal: number;
 };
 /**
- * Caller-facing knobs for the SDK's auto-idempotency retry on transient
- * first-chunk failures.
+ * Caller-facing knobs for retrying a transport-ambiguous event request under
+ * its identical durable identity.
  *
  * Defaults are tuned for interactive and agent latency budgets: 3 attempts
  * with exponential backoff capped at 8s, so a one-off flake recovers without
@@ -1406,11 +2876,12 @@ type StreamFailureCause = {
  * Error raised when a streamed commit submission fails after an ambiguous or
  * partial append.
  *
- * 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.
+ * `completedReceipts` contains only earlier, acknowledged event receipts. The
+ * other identity fields name the one pending chunk that must be looked up
+ * before any manual retry. `acknowledgedOperationCount` preserves progress
+ * even if a receipt omits operation rows. `attemptedAppendOutcome` and
+ * `lastAcknowledgedRepoSeq` retain recovery information from the earlier
+ * stream contract; the durable receipt remains the authoritative record.
  *
  * @see https://docs.warmhub.ai/sdk/transient-retry/#partial-submissions
  */
@@ -1420,29 +2891,55 @@ declare class PartialStreamSubmissionError extends Error {
      */
     readonly code = "PARTIAL_STREAM_SUBMISSION";
     /**
-     * Operations the SDK confirmed completed before the ambiguous or failing
-     * append. The remaining operations may or may not have landed; inspect
-     * repository state before retrying manually.
+     * Earlier exact receipts, in submission order.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/partialstreamsubmissionerror/#completedreceipts
+     */
+    readonly completedReceipts: readonly OperationEventReceiptV1$1[];
+    /**
+     * Legacy projection of operations confirmed before the failed append.
      * @see https://docs.warmhub.ai/sdk-reference/classes/partialstreamsubmissionerror/#completedoperations
      */
     readonly completedOperations: SubmittedStreamResult['operations'];
+    readonly submissionId: string;
+    readonly eventRequestId: string;
+    readonly chunkOrdinal: number;
+    readonly pendingOutcome: 'absent' | 'unknown';
     /**
-     * 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.
+     * Number of operations covered by acknowledged append responses.
      * @see https://docs.warmhub.ai/sdk-reference/classes/partialstreamsubmissionerror/#acknowledgedoperationcount
      */
     readonly acknowledgedOperationCount: number;
+    /**
+     * Last repository sequence returned by an acknowledged chunk that persisted
+     * an event. This is a lower bound for known completed work, never evidence
+     * that the attempted append did not land.
+     */
+    readonly lastAcknowledgedRepoSeq?: number;
+    /**
+     * Authoritative outcome of the attempted append. `not_applied` is used only
+     * when the SDK received explicit server rejection evidence; `unknown` means
+     * callers must stop writes and reconcile from a later verified checkpoint.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/partialstreamsubmissionerror/#attemptedappendoutcome
+     */
+    readonly attemptedAppendOutcome: 'not_applied' | 'unknown';
     /**
      * Underlying error that triggered the partial submission, preserved for
-     * diagnostics. Inspect via `isWarmHubError(err.cause)` / `err.cause.kind`.
+     * diagnostics. Do not infer append outcome from this field; branch on
+     * `attemptedAppendOutcome` instead.
      * @see https://docs.warmhub.ai/sdk-reference/classes/partialstreamsubmissionerror/#cause
      */
     readonly cause: unknown;
     constructor(input: {
         cause: unknown;
-        completedOperations: SubmittedStreamResult['operations'];
+        completedReceipts: readonly OperationEventReceiptV1$1[];
+        completedOperations?: SubmittedStreamResult['operations'];
         acknowledgedOperationCount?: number;
+        lastAcknowledgedRepoSeq?: number;
+        attemptedAppendOutcome: 'not_applied' | 'unknown';
+        submissionId: string;
+        eventRequestId: string;
+        chunkOrdinal: number;
+        pendingOutcome: 'absent' | 'unknown';
     });
 }
 /**
@@ -1452,6 +2949,11 @@ declare class PartialStreamSubmissionError extends Error {
  */
 declare class AllStreamOperationsFailedError extends Error {
     readonly code = "STREAM_ALL_OPERATIONS_FAILED";
+    /**
+     * Every exact immutable receipt returned for the rejected submission.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/allstreamoperationsfailederror/#receipts
+     */
+    readonly receipts: readonly OperationEventReceiptV1$1[];
     readonly result: SubmittedStreamResult;
     readonly operations: SubmittedStreamResult['operations'];
     readonly statusCounts: NonNullable<SubmittedStreamResult['statusCounts']>;
@@ -1463,73 +2965,34 @@ declare class AllStreamOperationsFailedError extends Error {
  * Submit `operations` to the WarmHub stream-append surface, chunked to
  * stay under MAX_STREAM_APPEND_OPERATION_COUNT.
  *
- * **Retry policy (default-on, first-chunk + single-op only).** A
- * 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`, 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.
- *
- * 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 (`acknowledgedOperationCount > 0`)
- * also bypass retry. Both surface `PartialStreamSubmissionError`; callers must
- * inspect repository state and resume only operations known not to have landed.
+ * Each chunk is one atomic operation event. The SDK mints one submission UUID,
+ * derives each chunk's request UUID from its zero-based ordinal, and preserves
+ * both identities across transport-ambiguous retries. A successful submission
+ * returns the legacy aggregate write result plus ordered exact receipts, one
+ * per chunk.
  *
  * Definite client rejections (`UNAUTHENTICATED`, `VALIDATION_ERROR`,
  * `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`
- * (for `add`) or `ALREADY_RETRACTED` (for `retract`) directly so the
- * caller sees the truth.
- *
- * `COMMIT_OUTCOME_UNKNOWN` is terminal but ambiguous: the SDK never
- * replays it and surfaces `PartialStreamSubmissionError` with the original
- * cause so callers must inspect repository state before continuing.
+ * the response was lost, the same-identity retry returns the original durable
+ * receipt instead of reapplying the operation or translating the replay into
+ * a new conflict.
  *
- * **Ambiguity preservation across attempts.** Once any attempt has
- * been transport-ambiguous (timeout / 5xx / reset), a subsequent
- * definite-reject (e.g. `RATE_LIMITED` on a quota check) does *not*
- * prove the prior attempt didn't land. In that case the SDK wraps the
- * cause as `PartialStreamSubmissionError` instead of rethrowing raw,
- * so the "inspect repo state before continuing" warning survives.
+ * If ambiguity remains after the retry budget, `PartialStreamSubmissionError`
+ * carries the exact pending request identity and every earlier receipt. The
+ * caller can use `client.commit.getReceipt` and retry the identical chunk only
+ * after an opaque not-found response.
  *
  * **Operation normalization.** `args.operations` accepts the public
  * `Operation[]` write contract. The SDK normalizes operations to the
  * backend stream shape before chunking, token checks, and appends.
  *
- * **Idempotency is the caller's responsibility.** To make `add` ops
- * idempotent under retry (the GH #2243 agent-health-write use case),
- * pass `skipExisting: true` per-op, via `args.skipExisting`, or via
- * `commit.apply`'s `opts`:
- *
- * ```ts
- * client.commit.apply(org, repo, msg, ops, { skipExisting: true })
- * ```
- *
- * `args.skipExisting: true` applies `skipExisting: true` to every
- * normalized `add` op. The server then returns `noop` for `add` ops
- * whose target already exists. `revise` is naturally idempotent on
- * equal `dataHash` + `aboutThingId`; built-in collection adds dedupe
- * on `dataHash`.
- *
  * Pass `args.retry: false` to disable retry entirely; pass
  * `args.retry: { maxAttempts, baseDelayMs, maxDelayMs }` to override
  * any subset of the defaults (`{ 3, 250, 8_000 }`).
  *
- * Retry is automatically suppressed when the caller supplies
- * `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
- * full idempotency contract.
- *
  * @see https://docs.warmhub.ai/sdk/transient-retry/
  * @internal
  */
@@ -1543,25 +3006,74 @@ declare function submitOperationsViaStream(client: OperationStreamClient, args:
     chunkSize?: number;
     skipExisting?: boolean;
     streamId?: string;
+    submissionId?: string;
     /** Return the writer's own repository-sequence acknowledgement. */
     returnRepoSeq?: boolean;
     /**
-     * Bounded auto-idempotency retry for transient first-chunk failures.
+     * Bounded retry for transport-ambiguous operation-event responses.
      * Default-on (3 attempts, 250ms base, 8s cap, jittered exponential).
-     * Pass `false` to disable. Multi-chunk mid-flight failures still
-     * surface PartialStreamSubmissionError unchanged.
+     * Pass `false` to disable.
      */
     retry?: RetryPolicyOptions | false;
 }): Promise<SubmittedStreamResult>;
+/**
+ * Rebase one chunk's result rows onto submission-global operation indexes.
+ * Single owner of the `chunkStart + (opIndex ?? position)` convention — chunk
+ * accumulators (SDK and CLI) must use this rather than re-deriving it.
+ *
+ * @internal
+ */
+declare function offsetChunkResultIndexes(results: StreamAppendResult$1['results'], chunkStart: number): StreamAppendResult$1['results'];
+/**
+ * Derive the legacy aggregate write result from accumulated stream-append
+ * outputs. This is the single owner of the receipt-era → legacy status
+ * mapping; CLI and other callers that accumulate chunks themselves must use
+ * this rather than re-implementing the projection.
+ *
+ * `operations` only needs the submitted names (used to echo `submittedName`
+ * on failed rows); pass lightweight `{name}` records when the full submitted
+ * operations are not retained.
+ *
+ * @internal
+ */
+declare function aggregateSubmittedStreamResult(input: {
+    committer?: string;
+    createdByEmail?: string;
+    message?: string;
+    operations: ReadonlyArray<{
+        name?: string;
+    }>;
+    repoSeq?: number;
+    receipts: OperationEventReceiptV1$1[];
+    results: StreamAppendResult$1['results'];
+}): SubmittedStreamResult;
+/**
+ * Operations from an aggregate that were confirmed applied or noop.
+ *
+ * @internal
+ */
+declare function completedOperationsFrom(result: SubmittedStreamResult): SubmittedStreamResult['operations'];
 
 /**
  * Exposed for unit tests and internal callers to avoid re-deriving status values.
  *
  * @internal
  */
-declare function streamAppendResultStatus(result: StreamAppendResult$1['results'][number]): NonNullable<SubmittedStreamResult['operations'][number]['status']>;
+declare function streamAppendResultStatus(result: StreamAppendResult$1['results'][number]): 'applied' | 'noop' | 'error';
 /** @internal */
-declare function countStreamAppendResultStatuses(results: StreamAppendResult$1['results']): NonNullable<SubmittedStreamResult['statusCounts']>;
+declare function countStreamAppendResultStatuses(results: StreamAppendResult$1['results']): {
+    applied: number;
+    noop: number;
+    error: number;
+};
+/**
+ * True when stream append produced a definite pre-apply rejection rather than
+ * a transport-ambiguous outcome. A 4xx response (except timeout-shaped 408) is
+ * definite even when callers may choose to retry it later, as with 429.
+ *
+ * @internal
+ */
+declare function isDefiniteStreamAppendRejection(cause: unknown): boolean;
 
 /**
  * Server-side verifier for component CLI dispatch calls.
@@ -1821,6 +3333,11 @@ interface RetractOp {
      * Optional human-readable retraction reason.
      */
     readonly reason?: string;
+    /**
+     * Optional optimistic-concurrency precondition. When supplied, the retract
+     * is applied only if the target is still at this version number.
+     */
+    readonly expectedVersion?: number;
     /**
      * Optional read-lease token (#3625) returned by `thing.getWithLease`. When
      * it matches the target's active lease the lease auto-releases on commit;
@@ -1943,15 +3460,11 @@ declare class OperationBuilder {
     /**
      * Add a retract operation.
      *
-     * Pass a wref string shorthand or an object with a target name, optional kind safety hint, and optional reason.
+     * Pass a wref string shorthand or an object with retract options such as a
+     * kind safety hint, reason, expected version, or lease ID.
      * @see https://docs.warmhub.ai/sdk-reference/classes/operationbuilder/#retract
      */
-    retract(target: string | {
-        name: string;
-        kind?: CommitOperationKind;
-        reason?: string;
-        leaseId?: string;
-    }): this;
+    retract(target: string | Omit<RetractOp, 'operation'>): this;
     /**
      * Return the queued operations.
      *
@@ -1998,13 +3511,17 @@ 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. 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.
+     * A successful call returns the same ordered exact receipts as
+     * `client.commit.apply` and makes the builder single-use. A
+     * `PartialStreamSubmissionError` also seals the builder to prevent a retry
+     * under a different request identity.
      *
      * @param params.client WarmHub client or compatible stream client used for submission.
      * @param params.message Optional commit message.
      * @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 Caller-managed stream identity for observability and diagnostic correlation.
+     * @param params.submissionId Caller-managed UUID shared by every chunk.
      * @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
@@ -2017,6 +3534,7 @@ declare class OperationBuilder {
         message?: string;
         chunkSize?: number;
         streamId?: string;
+        submissionId?: string;
         returnRepoSeq?: boolean;
         retry?: RetryPolicyOptions | false;
     }): Promise<OperationSubmitResult$1>;
@@ -2024,6 +3542,22 @@ declare class OperationBuilder {
     private assertCanModify;
 }
 
+/**
+ * Mint the identity shared by every event in one logical submission.
+ * @see https://docs.warmhub.ai/sdk-reference/functions/createoperationeventsubmissionid/
+ */
+declare function createOperationEventSubmissionId(): string;
+/**
+ * Mint the request identity used by direct operation-event submissions.
+ * @see https://docs.warmhub.ai/sdk-reference/variables/createoperationeventrequestid/
+ */
+declare const createOperationEventRequestId: typeof createOperationEventSubmissionId;
+/**
+ * Derive the ratified UUIDv5 request identity for one stream chunk.
+ * @see https://docs.warmhub.ai/sdk-reference/functions/operationeventstreamrequestid/
+ */
+declare function operationEventStreamRequestId(submissionId: string, chunkOrdinal: number): string;
+
 /**
  * Version string for the installed SDK package.
  * @see https://docs.warmhub.ai/sdk-reference/variables/sdk_version/
@@ -2044,6 +3578,12 @@ type StreamAppendInput = StreamAppendInput$1;
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/streamappendresult/
  */
 type StreamAppendResult = StreamAppendResult$1;
+/**
+ * The exact immutable receipt returned by every public write and lookup.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/operationeventreceiptv1/
+ */
+type OperationEventReceiptV1 = OperationEventReceiptV1$1;
+
 /**
  * Remove an `@vN`, `@HEAD`, or `@ALL` version suffix from a wref.
  *
@@ -2079,11 +3619,12 @@ interface WarmHubClientOptions {
     functionLogs?: FunctionLogMode;
     /**
      * Self-identification sent on the `X-WarmHub-Client` header (`name/version`)
-     * for backend observability + read-analytics surface attribution. Defaults to
-     * `@warmhub/sdk-ts/<SDK_VERSION>`. A wrapper such as the WarmHub CLI overrides
-     * `name` (and usually `version`) to identify itself instead. An untrusted
-     * hint — never an authz signal. A per-request `X-WarmHub-Client` header on a
-     * raw request still wins over this default.
+     * for backend observability, compatibility admission, and read-analytics
+     * surface attribution. Defaults to `@warmhub/sdk-ts/<SDK_VERSION>`. A wrapper
+     * such as the WarmHub CLI overrides both values to identify its actual
+     * released artifact. An untrusted safety hint — never an authz signal. A
+     * per-request `X-WarmHub-Client` header on a raw request still wins over this
+     * default.
      */
     client?: {
         name?: string;
@@ -2147,7 +3688,7 @@ type SubscriptionUnbindArgs = [orgName: string, repoName: string, subscriptionNa
     }
 ];
 /** @internal */
-type CoreErrorKind = 'BACKEND' | 'NOT_FOUND' | 'FORBIDDEN' | 'UNAUTHENTICATED' | 'VALIDATION_ERROR' | 'CONFLICT' | 'RATE_LIMITED' | 'CANCELLED' | 'NETWORK';
+type CoreErrorKind = 'BACKEND' | 'NOT_FOUND' | 'FORBIDDEN' | 'UNAUTHENTICATED' | 'VALIDATION_ERROR' | 'CONFLICT' | 'RATE_LIMITED' | 'CANCELLED' | 'CLIENT_INCOMPATIBLE' | 'NETWORK';
 /**
  * Stable SDK error kinds plus backend domain codes that pass through as strings.
  *
@@ -2165,6 +3706,7 @@ type CoreErrorKind = 'BACKEND' | 'NOT_FOUND' | 'FORBIDDEN' | 'UNAUTHENTICATED' |
  * - `CONFLICT` — cause: write collides with current state (concurrent edit, name already in use); retryable: false; action: refetch the current state and reconcile before retrying the write; origin: commit pipeline, repo/org creation. Archived org / repo writes surface as the pass-through code `ARCHIVED`, not `CONFLICT`.
  * - `RATE_LIMITED` — cause: caller exceeded the per-token or per-org request budget; retryable: true; action: wait {@link WarmHubError.retryAfter} seconds before retrying; origin: REST + tRPC throttling
  * - `CANCELLED` — cause: caller aborted the request via `AbortSignal`; retryable: true; action: retry only if the caller still wants the result; origin: SDK `AbortError` mapping
+ * - `CLIENT_INCOMPATIBLE` — cause: the client family/version or write contract is incompatible with the backend; retryable: false; action: follow the error hint to upgrade the client or backend; origin: SDK write preflight and backend mutation admission
  * - `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`,
@@ -2182,12 +3724,12 @@ type CoreErrorKind = 'BACKEND' | 'NOT_FOUND' | 'FORBIDDEN' | 'UNAUTHENTICATED' |
  */
 type ErrorKind = CoreErrorKind | (string & {});
 /**
- * Result returned by successful commit submissions.
+ * Legacy commit result fields plus ordered exact receipts for every submitted chunk.
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/operationsubmitresult/
  */
 type OperationSubmitResult = SubmittedStreamResult;
 /** @internal */
-type ShapeChange = ShapeChangeResult;
+type ShapeChange = ShapeChangeCompatibilityResult;
 /** @internal */
 type Shape = ShapeGetResult;
 /** @internal */
@@ -2196,13 +3738,11 @@ type ShapeList = ShapeListResult;
  * Result of `client.shape.remove` — confirms the retraction with the new version metadata.
  * @internal
  */
-type ShapeRemove = {
-    name: string;
-    operation: ShapeRemoveResult['operation'];
-    version: number;
-    dataHash: string;
-    removed: true;
-};
+type ShapeRemove = ShapeRemoveCompatibilityResult;
+/** @internal */
+type RenameResult = RenameCompatibilityResult;
+/** @internal */
+type CommitApplyCompatibilityResult = CommitApplyCompatibilityResult$1;
 /**
  * Shape of a subscription record returned from `client.subscription.list`,
  * `client.subscription.get`, `client.subscription.create`, and
@@ -2240,6 +3780,32 @@ type SubscriptionInfo = {
     notifyOnSuccess?: boolean;
     componentRef?: string;
     credentialSetNames: Array<string>;
+    /**
+     * Immutable operation-event routing revision. Absent for metadata and legacy
+     * cron subscriptions. It describes stored router state; legacy delivery
+     * remains in effect until the exact router is activated.
+     */
+    operationSubscription?: {
+        /** Omitted when current source-repository authority no longer permits its label. */
+        effectiveSourceRepo?: string;
+        revision: number;
+        lifecycle: 'active' | 'paused' | 'retired';
+        routingStatus: 'dormant' | 'active';
+        routingGeneration: number;
+        routingShard: number | null;
+        matcherVersion: string;
+        matcherDigest: string;
+        targetGeneration: number;
+        credentialGeneration: number;
+        deliveryPolicy: {
+            allowTraceReentry: boolean | null;
+            notifyOnSuccess: boolean;
+        };
+        retirement?: {
+            retiredAt: number;
+            reason: string;
+        };
+    };
     createdAt: number;
 };
 /**
@@ -2361,16 +3927,6 @@ type ActionDeliveryTarget = string | {
     deliveryId: string;
     runId?: never;
 };
-/**
- * Result returned by in-place rename mutations: `client.shape.rename` and
- * `client.thing.rename`. A rename patches the identity field directly and
- * preserves the existing version history; no new version is created. The
- * `renamed: true` discriminator distinguishes the success shape from a
- * rejected request (which throws `WarmHubError`).
- *
- * @see https://docs.warmhub.ai/data-modeling/naming-as-navigation/
- */
-type RenameResult = RenameResult$1;
 /** @internal Curated lists returned by `client.homepage.featuredLists()`. */
 type HomepageFeaturedListsResult = HomepageFeaturedListsResult$1;
 /**
@@ -2417,6 +3973,22 @@ type ComponentHistoryOptions = {
 type ComponentInstallResult = ComponentInstallResult$1;
 /** @internal */
 type ComponentUninstallResult = ComponentUninstallResult$1;
+/**
+ * Caller-owned root identity for component installation repository-write
+ * receipts. Reuse it only when recovering the same install submission.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/componentinstalloptions/
+ */
+type ComponentInstallOptions = {
+    submissionId: string;
+};
+/**
+ * Caller-owned root identity for component teardown repository-write receipts.
+ * Reuse it only when recovering the same teardown submission.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/componentuninstalloptions/
+ */
+type ComponentUninstallOptions = {
+    submissionId: string;
+};
 /** @internal */
 type ComponentListOptions = {
     limit?: number;
@@ -2506,13 +4078,26 @@ type ShapeGetOptions = {
 };
 /** @internal */
 type ShapeCreateOptions = {
+    eventRequestId: string;
     description?: string;
 };
 /** @internal */
 type ShapeReviseOptions = {
+    eventRequestId: string;
     description?: string;
 };
 /** @internal */
+type ShapeRemoveOptions = {
+    eventRequestId: string;
+};
+/**
+ * Caller-owned UUID retained across an ambiguous rename retry.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/renameoptions/
+ */
+type RenameOptions = {
+    eventRequestId: string;
+};
+/** @internal */
 interface ShapeHistoryOptions {
     includeRetracted?: boolean;
     limit?: number;
@@ -2998,6 +4583,7 @@ type LiveRepoEvent = {
 };
 /** @internal */
 type ActionListRunsOptions = {
+    runId?: string;
     subscriptionName?: string;
     status?: 'pending' | 'running' | 'processing' | 'retry_wait' | 'succeeded' | 'suppressed' | 'failed_terminal' | 'dead_letter';
     outcome?: 'succeeded' | 'failed';
@@ -3137,6 +4723,8 @@ type RefsResult = RefsResult$1;
 /** @internal */
 type CollectionType = CollectionType$1;
 /** @internal */
+type CollectionMutationResult = CollectionMutationCompatibilityResult;
+/** @internal */
 type CollectionMember = CollectionMember$1;
 /** @internal */
 type CollectionMembersPage = CollectionMembersPage$1;
@@ -3145,7 +4733,6 @@ type CollectionContainsResult = CollectionContainsResult$1;
 /** @internal */
 type CollectionDiffResult = CollectionDiffResult$1;
 /** @internal */
-type CollectionMutationResult = CollectionMutationResult$1;
 /** @internal */
 type CollectionStatsResult = CollectionStatsResult$1;
 /** @internal */
@@ -3314,6 +4901,8 @@ type CollectionMemberSourceOptions = {
 };
 /** @internal */
 type CollectionCreateOptions = {
+    /** Caller-owned UUID retained across ambiguous retries. */
+    eventRequestId: string;
     type: CollectionType;
     name: string;
     from?: string;
@@ -3343,6 +4932,8 @@ type CollectionDiffOptions = {
 };
 /** @internal */
 type CollectionReviseOptions = {
+    /** Caller-owned UUID retained across ambiguous retries. */
+    eventRequestId: string;
     add?: string[];
     remove?: string[];
     message?: string;
@@ -3370,7 +4961,9 @@ declare function resolveFunctionLogMode(mode?: FunctionLogMode): FunctionLogMode
  * after a `lease_held` to back off until the lease expires (#3625).
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/warmhuberrordetails/
  */
-type WarmHubErrorDetails = NonNullable<NonNullable<StreamAppendResult$1['results'][number]['error']>['details']>;
+type WarmHubErrorDetails = NonNullable<NonNullable<Extract<OperationEventReceiptV1$1['operations'][number], {
+    error?: unknown;
+}>['error']>['details']>;
 /** @internal */
 declare function sanitizeErrorMessage(message: string): string;
 /**
@@ -3499,10 +5092,9 @@ declare function isConnectionError(error: unknown): boolean;
 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.
+ * arguments must be valid SemVer; non-parseable inputs return false for this
+ * legacy read-side helper. Write admission validates both values separately
+ * and fails closed.
  *
  * @internal
  */
@@ -3557,6 +5149,8 @@ declare class WarmHubClient {
     protected readonly getToken?: () => Promise<string | undefined>;
     private readonly trpc;
     private compatibilityCheck?;
+    private assertWriteCompatible;
+    private createCompatibilityLink;
     /**
      * Authentication helpers for browser sign-in flows, session checks, and token diagnostics.
      * @see https://docs.warmhub.ai/sdk-reference/classes/warmhubclient/#auth
@@ -3624,17 +5218,16 @@ declare class WarmHubClient {
          */
         ping: () => Promise<PingResult>;
         /**
-         * Return backend API version, minimum supported SDK version, and feature flags.
+         * Return backend API version, per-client floors, write-contract 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.
+         * Verify this client family/version and the backend can safely write,
+         * throwing an actionable `WarmHubError` when either side is incompatible.
          *
          * 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.
+         * client) to fail fast on either direction of version skew. Mutations call
+         * the same cached check automatically before dispatch.
          * 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.
          *
@@ -3722,8 +5315,12 @@ declare class WarmHubClient {
          *
          * Reinstall is idempotent: the install identity (`installId`) is reused so
          * runtime tokens keyed on it survive teardown/reinstall.
+         *
+         * `options.submissionId` groups deterministic receipts for the repository
+         * mutation phases only. Credential/subscription reconciliation and setup
+         * callbacks retain their existing lifecycle semantics.
          */
-        install: (orgName: string, repoName: string, componentRef: string) => Promise<ComponentInstallResult>;
+        install: (orgName: string, repoName: string, componentRef: string, options: ComponentInstallOptions) => Promise<ComponentInstallResult>;
         /**
          * Uninstall a registered component from a repository (GH-4677).
          *
@@ -3738,8 +5335,11 @@ declare class WarmHubClient {
          *
          * Non-destructive: manifest shapes and seeded data are left intact (only
          * repo deletion removes those) and reinstall revives the install.
+         * `options.submissionId` groups deterministic receipts for repository
+         * mutation phases; it does not make callbacks or token lifecycle work one
+         * atomic submission.
          */
-        uninstall: (orgName: string, repoName: string, componentRef: string) => Promise<ComponentUninstallResult>;
+        uninstall: (orgName: string, repoName: string, componentRef: string, options: ComponentUninstallOptions) => Promise<ComponentUninstallResult>;
         /**
          * Registered-component identity and install-pipeline operations.
          *
@@ -3789,21 +5389,21 @@ 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. 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.
+         * Transport-ambiguous failures retry with the identical submission ID and
+         * chunk ordinal. If ambiguity remains, `PartialStreamSubmissionError`
+         * carries the pending `eventRequestId` and every earlier exact receipt.
          *
          * Writing to an archived organization or repository fails with an `ARCHIVED` error before any operations are applied.
          *
          * @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 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.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. Exact operation-event receipts do not echo this input; 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.
          * @param opts.streamId Caller-managed stream identity for observability and diagnostic correlation.
-         * @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.submissionId Caller-selected UUID correlating all chunks.
+         * When omitted, the SDK mints one before the first network request.
          * @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?: {
@@ -3812,9 +5412,12 @@ declare class WarmHubClient {
             chunkSize?: number;
             skipExisting?: boolean;
             streamId?: string;
+            submissionId?: string;
             returnRepoSeq?: boolean;
             retry?: RetryPolicyOptions | false;
         }) => Promise<OperationSubmitResult>;
+        /** Recover one immutable write receipt after an ambiguous response. */
+        getReceipt: (orgName: string, repoName: string, eventRequestId: string) => Promise<OperationEventReceiptV1>;
     };
     /**
      * Organization management surface for namespaces, membership, roles, and scoped member permissions.
@@ -3938,6 +5541,43 @@ declare class WarmHubClient {
      * @see https://docs.warmhub.ai/sdk/repo-stats/
      */
     readonly repo: {
+        /**
+         * Repository checkpoint lifecycle and artifact-access operations.
+         *
+         * Reads require unrestricted `repo:read` plus `repo:checkpoint-read`;
+         * generation and retry additionally require `repo:admin`.
+         *
+         * `getAccess` returns a signed artifact descriptor only. It does not fetch
+         * the signed URL or attach the WarmHub bearer token to that URL.
+         */
+        checkpoint: {
+            generate: (orgName: string, repoName: string, options?: {
+                atLeastRepoSeq?: number;
+            }) => Promise<RepositoryCheckpointStatus>;
+            status: (orgName: string, repoName: string, selector: {
+                checkpointId: string;
+                repoSeq?: never;
+            } | {
+                repoSeq: number;
+                checkpointId?: never;
+            }) => Promise<RepositoryCheckpointStatus>;
+            latest: (orgName: string, repoName: string) => Promise<(RepositoryCheckpointStatus & {
+                state: "complete";
+            }) | null>;
+            getAccess: (orgName: string, repoName: string, input: {
+                checkpoint: "latest" | ({
+                    checkpointId: string;
+                    repoSeq?: never;
+                } | {
+                    repoSeq: number;
+                    checkpointId?: never;
+                });
+                artifact: "archive" | "manifest" | {
+                    chunkPath: string;
+                };
+            }) => Promise<RepositoryCheckpointAccess>;
+            retry: (orgName: string, repoName: string, checkpointId: string) => Promise<RepositoryCheckpointStatus>;
+        };
         /**
          * Get a repository by organization and repository name.
          */
@@ -4183,13 +5823,20 @@ declare class WarmHubClient {
         /**
          * Commit a new `Content/Readme` value.
          *
-         * The backend adds or revises the content record through the normal commit pipeline.
+         * The backend adds or revises the content record through the normal commit
+         * pipeline. Create `opts.eventRequestId` before submission and reuse it to
+         * look up or retry an ambiguous outcome.
          */
-        setReadme: (orgName: string, repoName: string, content: string) => Promise<CommitApplyResult>;
+        setReadme: (orgName: string, repoName: string, content: string, opts: {
+            eventRequestId: string;
+        }) => Promise<CommitApplyCompatibilityResult>;
         /**
          * Commit a new `Content/Agents` value through the normal commit pipeline.
+         * The caller owns `opts.eventRequestId` across ambiguous retries.
          */
-        setAgents: (orgName: string, repoName: string, content: string) => Promise<CommitApplyResult>;
+        setAgents: (orgName: string, repoName: string, content: string, opts: {
+            eventRequestId: string;
+        }) => Promise<CommitApplyCompatibilityResult>;
         /**
          * Fetch the synthesized `Content/LlmsTxt` sitemap for a repository.
          *
@@ -4223,11 +5870,9 @@ declare class WarmHubClient {
          *
          * Returns the full shape thing record, with `name`,
          * `kind: "shape"`, `active`, and a nested `version: { version, operation,
-         * data, dataHash } | null`. This is **not** the same shape as the
-         * shape returned by `create` and `revise`: the change result
-         * is flat (`name`, `operation`, `version: number`, `dataHash`) and does
-         * not carry `data`. To read shape fields, call `get` and read
-         * `result.version?.data` — the change result alone is not enough.
+         * data, dataHash } | null`. Shape mutations return immutable operation-event
+         * receipts, not this read projection. To read shape fields, call `get` and
+         * read `result.version?.data`.
          *
          * @param opts.includeRetracted Include a retracted shape instead of treating it as missing.
          */
@@ -4237,35 +5882,41 @@ declare class WarmHubClient {
          *
          * Shape data should describe the fields used to validate things and assertions with that shape.
          *
-         * Returns `{ name, operation, version, dataHash }`.
-         * The result confirms the write and exposes the new version number, but it
-         * does **not** include the shape data — call `client.shape.get` for the
-         * full shape record (with `kind`, `active`, and nested
-         * `version.data`).
+         * Returns the existing shape-change fields plus a nested immutable receipt.
+         * Supply `opts.eventRequestId` when the caller needs stable receipt lookup
+         * or safe retry after an ambiguous response; legacy callers may omit it.
          *
+         * @param opts.eventRequestId Caller-owned UUID retained across ambiguous retries.
          * @param opts.description Optional human-readable shape description.
          */
-        create: (orgName: string, repoName: string, shapeName: string, fields: Record<string, unknown>, opts?: ShapeCreateOptions) => Promise<ShapeChange>;
+        create: (orgName: string, repoName: string, shapeName: string, fields: Record<string, unknown>, opts: ShapeCreateOptions) => Promise<ShapeChange>;
         /**
          * Revise a shape definition, creating a new shape version.
          *
-         * Returns `{ name, operation, version, dataHash }`,
-         * the same flat shape as `create`. To read the revised fields back, call
-         * `client.shape.get` for the full shape record.
+         * Returns the existing shape-change fields plus a nested immutable receipt.
+         * A supplied `opts.eventRequestId` remains stable across ambiguous retries.
          *
+         * @param opts.eventRequestId Caller-owned UUID retained across ambiguous retries.
          * @param opts.description Optional human-readable description for the revised shape.
          */
-        revise: (orgName: string, repoName: string, shapeName: string, newFields: Record<string, unknown>, opts?: ShapeReviseOptions) => Promise<ShapeChange>;
+        revise: (orgName: string, repoName: string, shapeName: string, newFields: Record<string, unknown>, opts: ShapeReviseOptions) => Promise<ShapeChange>;
         /**
          * Retract a shape definition.
+         *
+         * Returns the existing removal fields plus a nested immutable receipt.
+         * A supplied `opts.eventRequestId` remains stable across ambiguous retries.
+         *
+         * @param opts.eventRequestId Caller-owned UUID retained across ambiguous retries.
          */
-        remove: (orgName: string, repoName: string, shapeName: string) => Promise<ShapeRemove>;
+        remove: (orgName: string, repoName: string, shapeName: string, opts: ShapeRemoveOptions) => Promise<ShapeRemove>;
         /**
          * Rename a shape within a repository.
          *
-         * The rename is applied in place: the existing shape history is preserved and no new version is created.
+         * The rename is applied in place: the existing shape history is preserved
+         * and no new version is created. Retain `opts.eventRequestId` for an exact
+         * receipt replay after an ambiguous response.
          */
-        rename: (orgName: string, repoName: string, oldName: string, newName: string) => Promise<RenameResult>;
+        rename: (orgName: string, repoName: string, oldName: string, newName: string, opts: RenameOptions) => Promise<RenameResult>;
         /**
          * Return add, revise, retract, and rename history for a shape.
          *
@@ -4363,9 +6014,12 @@ declare class WarmHubClient {
             active: boolean;
         }>;
         /**
-         * Delete a subscription.
+         * Remove a subscription.
          *
-         * Omit `repoName` (object form) to delete an org-scoped subscription.
+         * Operation subscriptions are immediately retired: delivery stops, the
+         * identity remains auditable, and the name stays reserved. Metadata and
+         * legacy cron subscriptions are deleted. Omit `repoName` (object form) for
+         * an org-scoped subscription.
          */
         remove: (...args: SubscriptionRefArgs) => Promise<{
             ok: true;
@@ -4687,9 +6341,11 @@ declare class WarmHubClient {
         /**
          * Rename a thing within its shape namespace.
          *
-         * The rename is applied in place: the thing's existing history is preserved and no new version is created.
+         * The rename is applied in place: the thing's existing history is preserved
+         * and no new version is created. Retain `opts.eventRequestId` for an exact
+         * receipt replay after an ambiguous response.
          */
-        rename: (orgName: string, repoName: string, shapeName: string, oldName: string, newName: string) => Promise<RenameResult>;
+        rename: (orgName: string, repoName: string, shapeName: string, oldName: string, newName: string, opts: RenameOptions) => Promise<RenameResult>;
         /**
          * Resolve a wref to its current projected record.
          */
@@ -5205,4 +6861,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 ActionLiveFeedItem, 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 HistoryVersion, 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 RepoExploreBrowseOptions, type RepoExploreItem, type RepoExploreOptions, type RepoExploreResult, type RepoInfo, type RepoLicense, 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 ThingChanges, type ThingDetail, type ThingGet, type ThingGetManyResult, type ThingGetOptions, type ThingGetWithLease, type ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadChangesOptions, type ThingHeadOptions, type ThingHeadRequest, type ThingHeadVersionsResult, type ThingHistory, type ThingHistoryOptions, type ThingItem, type ThingMetadata, type ThingQueryChangesOptions, 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 ActionLiveFeedItem, 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 CommitApplyCompatibilityResult, type ComponentHistory, type ComponentHistoryOptions, type ComponentInfo, type ComponentInstallOptions, type ComponentInstallResult, type ComponentList, type ComponentListOptions, type ComponentUninstallOptions, 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 HistoryVersion, 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 OperationEventReceiptV1, 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 RenameOptions, type RenameResult, type RepoAccessResult, type RepoConfigureStatsView, type RepoDescribeResult, type RepoExploreBrowseOptions, type RepoExploreItem, type RepoExploreOptions, type RepoExploreResult, type RepoInfo, type RepoLicense, 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 RepositoryCheckpointAccess, type RepositoryCheckpointStatus, 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 ShapeRemoveOptions, 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 ThingChanges, type ThingDetail, type ThingGet, type ThingGetManyResult, type ThingGetOptions, type ThingGetWithLease, type ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadChangesOptions, type ThingHeadOptions, type ThingHeadRequest, type ThingHeadVersionsResult, type ThingHistory, type ThingHistoryOptions, type ThingItem, type ThingMetadata, type ThingQueryChangesOptions, 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, aggregateSubmittedStreamResult, completedOperationsFrom, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, createOperationEventRequestId, createOperationEventSubmissionId, isConnectionError, isDefiniteStreamAppendRejection, isRetryable, isWarmHubError, normalizeWref, offsetChunkResultIndexes, operationEventStreamRequestId, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall };