@opengeni/sdk 3.3.2-canary.1 → 3.4.0

package/dist/codex-realtime-controller.d.ts

@@ -28,7 +28,20 @@ export type CodexRealtimeControllerSnapshot = {
     reconnectAttempt: number;
     diagnostic: CodexRealtimeDiagnostic | null;
     error: string | null;
+    /**
+     * Set when Opengeni refused or ended deployment-funded voice for credits or
+     * availability. Codes match voice input: `insufficient_credits`,
+     * `allowance_exhausted`, `monthly_model_cost_limit`, plus
+     * `realtime_voice_unavailable`. Cleared on the next start.
+     */
+    refusal?: CodexRealtimeRefusal | null;
 };
+export type CodexRealtimeRefusal = {
+    code: string;
+    message: string;
+};
+/** A definitive credit/availability refusal from Opengeni, with its plain message. */
+export declare function codexRealtimeRefusal(error: unknown): CodexRealtimeRefusal | null;
 export type CodexRealtimeControllerClient = {
     beginSessionRealtime(workspaceId: string, sessionId: string, request: BeginSessionRealtimeRequest): Promise<SessionRealtimeMutationResponse>;
     heartbeatSessionRealtime(workspaceId: string, sessionId: string, realtimeId: string, request: RenewSessionRealtimeRequest): Promise<SessionRealtimeMutationResponse>;

package/dist/codex-realtime-controller.js

@@ -1,14 +1,16 @@
 import {
   CODEX_REALTIME_NEGOTIATION_TIMEOUT_MS,
+  codexRealtimeRefusal,
   createCodexRealtimeController,
   hasStoredSessionRealtimeOwnerProof,
   projectSessionRealtimeLifecycle,
   sessionRealtimeOwnerStorageKey,
   sessionRealtimeOwnerStorageNamespace
-} from "./chunk-6NEPJ7NC.js";
-import "./chunk-OO5LPTO7.js";
+} from "./chunk-WVCJRSGJ.js";
+import "./chunk-7EWT3PV6.js";
 export {
   CODEX_REALTIME_NEGOTIATION_TIMEOUT_MS,
+  codexRealtimeRefusal,
   createCodexRealtimeController,
   hasStoredSessionRealtimeOwnerProof,
   projectSessionRealtimeLifecycle,

package/dist/codex-realtime-v3-wire.d.ts

@@ -3,7 +3,8 @@
  *
  * These shapes are pinned to openai/codex@fa1d4c40. V3 delegates work with
  * `delegation.created`; it does not expose the ordinary Realtime V2
- * `function_call` protocol.
+ * `function_call` protocol. `transcript.segment` is an application adapter
+ * extension for providers that emit fragments without semantic turn boundaries.
  */
 export declare const CODEX_REALTIME_INITIAL_ITEMS_MAX_COUNT = 128;
 export declare const CODEX_REALTIME_INITIAL_ITEMS_MAX_TOKENS = 8192;
@@ -32,7 +33,7 @@ export type CodexRealtimeV3Event = (ProviderEventIdentity & {
     startMs: number | null;
     endMs: number | null;
 }) | (ProviderEventIdentity & {
-    type: "turn.done";
+    type: "turn.done" | "transcript.segment";
     turnId: string;
     role: "user" | "assistant";
     transcript: string;

package/dist/codex-realtime.d.ts

@@ -15,6 +15,8 @@ export type AcquireCodexRealtimeMicrophoneOptions = {
 };
 export type StartCodexRealtimeWebrtcOptions = {
     negotiate: CodexRealtimeNegotiator;
+    /** Exact configured provider model expected from the server broker. */
+    expectedModel?: CodexRealtimeWebrtcResponse["model"];
     realtimeId: string;
     operationId: string;
     browserInstanceId: string;
@@ -54,6 +56,8 @@ export type CodexRealtimeWebrtcSession = {
     setOutputMuted(muted: boolean): void;
     activateRemoteAudio(): void;
     retryAudibleOutput(): Promise<boolean>;
+    /** Gracefully finish provider output before sealing the durable ledger. */
+    drain?(): Promise<void>;
     /** Idempotently close media, data channel, and peer transport. */
     stop(): void;
 };
@@ -61,7 +65,7 @@ export type CodexRealtimeWebrtcSession = {
  * Complete the browser half of native connected-Codex GPT-Live V3 negotiation.
  * Provider credentials never enter this boundary: `negotiate` sends SDP,
  * public session configuration, and the active browser-owner proof only to the
- * OpenGeni API.
+ * Opengeni API.
  */
 export declare function startCodexRealtimeWebrtc(options: StartCodexRealtimeWebrtcOptions): Promise<CodexRealtimeWebrtcSession>;
 export declare function acquireCodexRealtimeMicrophone(options?: AcquireCodexRealtimeMicrophoneOptions): Promise<MediaStream>;

package/dist/company-brain.d.ts

@@ -1,13 +1,7 @@
-import type { CompanyBrainContextReceiptPage as ContractCompanyBrainContextReceiptPage, CompanyBrainKnowledgeProposalPage as ContractCompanyBrainKnowledgeProposalPage, CompanyBrainOkfPackage as ContractCompanyBrainOkfPackage, KnowledgeBrowseRequest as ContractKnowledgeBrowseRequest, KnowledgeBrowseResponse as ContractKnowledgeBrowseResponse, KnowledgeGetResponse as ContractKnowledgeGetResponse, KnowledgeRecord as ContractKnowledgeRecord, KnowledgeSearchRequest as ContractKnowledgeSearchRequest, KnowledgeSearchResponse as ContractKnowledgeSearchResponse } from "@opengeni/contracts";
+import type { CompanyBrainContextReceiptPage as ContractCompanyBrainContextReceiptPage, CompanyBrainKnowledgeProposalPage as ContractCompanyBrainKnowledgeProposalPage, CompanyBrainOkfPackage as ContractCompanyBrainOkfPackage } from "@opengeni/contracts";
 export type CompanyBrainOkfPackage = ContractCompanyBrainOkfPackage;
 export type CompanyBrainContextReceiptPage = ContractCompanyBrainContextReceiptPage;
 export type CompanyBrainKnowledgeProposalPage = ContractCompanyBrainKnowledgeProposalPage;
-export type CompanyBrainKnowledgeSearchRequest = ContractKnowledgeSearchRequest;
-export type CompanyBrainKnowledgeSearchResponse = ContractKnowledgeSearchResponse;
-export type CompanyBrainKnowledgeBrowseRequest = ContractKnowledgeBrowseRequest;
-export type CompanyBrainKnowledgeBrowseResponse = ContractKnowledgeBrowseResponse;
-export type CompanyBrainKnowledgeGetResponse = ContractKnowledgeGetResponse;
-export type CompanyBrainKnowledgeRecord = ContractKnowledgeRecord;
 export type CompanyBrainContextReceiptListOptions = {
     attemptId?: string;
     cursor?: string;
@@ -19,10 +13,6 @@ export type CompanyBrainKnowledgeProposalListOptions = {
 export type CompanyBrainInspectorTransport = {
     requestJson<T>(method: string, path: string, body?: unknown): Promise<T>;
 };
-/** Human-authorized, permission-first Knowledge search for Company Brain inspectors. */
-export declare function searchCompanyBrainKnowledge(client: CompanyBrainInspectorTransport, workspaceId: string, request: CompanyBrainKnowledgeSearchRequest): Promise<CompanyBrainKnowledgeSearchResponse>;
-export declare function getCompanyBrainKnowledge(client: CompanyBrainInspectorTransport, workspaceId: string, recordId: string): Promise<CompanyBrainKnowledgeGetResponse>;
-export declare function browseCompanyBrainKnowledge(client: CompanyBrainInspectorTransport, workspaceId: string, request?: CompanyBrainKnowledgeBrowseRequest): Promise<CompanyBrainKnowledgeBrowseResponse>;
 export declare function listCompanyBrainContextReceipts(client: CompanyBrainInspectorTransport, workspaceId: string, options?: CompanyBrainContextReceiptListOptions): Promise<CompanyBrainContextReceiptPage>;
 export declare function listCompanyBrainKnowledgeProposals(client: CompanyBrainInspectorTransport, workspaceId: string, options?: CompanyBrainKnowledgeProposalListOptions): Promise<CompanyBrainKnowledgeProposalPage>;
 export type CompanyBrainOkfDownload = {

package/dist/core.d.ts

@@ -1,7 +1,11 @@
 /** Backward-compatible non-artifact client surface. */
 export { OpenGeniDocumentAuthorityClient as OpenGeniCoreClient } from "./document-authority-client.js";
-export type { FetchLike, GetSessionOptions, OpenGeniClientOptions, OpenGeniRequestOptions, SendMessageInput, SteerMessageResult, TranscribeAudioInput, WorkspaceControlEventPage, } from "./client.js";
-export { OpenGeniApiContractMismatchError, OpenGeniApiError, OpenGeniSecureContextRequiredError, OpenGeniSessionListCursorError, OpenGeniStreamError, isRetryableStreamError, } from "./errors.js";
+export { OpenGeniToolCallError, OpenGeniToolReapprovalRequiredError, OpenGeniToolsClient, } from "./tools.js";
+export type { OpenGeniGeneratedTools, OpenGeniDynamicToolNode, OpenGeniToolCallOptions, OpenGeniToolFunction, OpenGeniToolsFacade, OpenGeniWorkspaceTools, } from "./tools.js";
+export type { FetchLike, FetchResponse, GetSessionOptions, OpenGeniClientOptions, OpenGeniRequestOptions, SendMessageInput, SteerMessageResult, TranscribeAudioInput, WorkspaceControlEventPage, } from "./client.js";
+export { OpenGeniApiContractMismatchError, OpenGeniApiError, OpenGeniSetupError, OpenGeniSecureContextRequiredError, OpenGeniSessionListCursorError, OpenGeniStreamError, formatErrorMessage, isRetryableStreamError, } from "./errors.js";
 export type { OpenGeniSecureContextRequiredReason } from "./errors.js";
+export { parseDeprecationNotice } from "./deprecation.js";
+export type { OpenGeniDeprecationHandler, OpenGeniDeprecationNotice } from "./deprecation.js";
 export { resolveWorkspaceVoiceInputEnabled } from "./transcription.js";
 export { OPENGENI_API_CONTRACT_HEADER, OPENGENI_API_CONTRACT_REVISION } from "./types.js";

package/dist/core.js

@@ -1,23 +1,34 @@
 import {
   OpenGeniDocumentAuthorityClient
-} from "./chunk-BESZFWMU.js";
+} from "./chunk-OI5YLASH.js";
 import {
   resolveWorkspaceVoiceInputEnabled
-} from "./chunk-VYCTL62C.js";
-import "./chunk-GY6RQPCG.js";
+} from "./chunk-GZQSWAKD.js";
+import {
+  OpenGeniToolCallError,
+  OpenGeniToolReapprovalRequiredError,
+  OpenGeniToolsClient
+} from "./chunk-P7UWKORG.js";
+import {
+  parseDeprecationNotice
+} from "./chunk-S2NLS3ES.js";
+import "./chunk-X5ITQVXE.js";
+import "./chunk-4AHR4KGA.js";
 import {
   OPENGENI_API_CONTRACT_HEADER,
   OPENGENI_API_CONTRACT_REVISION
-} from "./chunk-E5BNEG2D.js";
-import "./chunk-QTBAMHEF.js";
+} from "./chunk-NCU5OAN7.js";
+import "./chunk-YJCHB7R3.js";
 import {
   OpenGeniApiContractMismatchError,
   OpenGeniApiError,
   OpenGeniSecureContextRequiredError,
   OpenGeniSessionListCursorError,
+  OpenGeniSetupError,
   OpenGeniStreamError,
+  formatErrorMessage,
   isRetryableStreamError
-} from "./chunk-OO5LPTO7.js";
+} from "./chunk-7EWT3PV6.js";
 export {
   OPENGENI_API_CONTRACT_HEADER,
   OPENGENI_API_CONTRACT_REVISION,
@@ -26,8 +37,14 @@ export {
   OpenGeniDocumentAuthorityClient as OpenGeniCoreClient,
   OpenGeniSecureContextRequiredError,
   OpenGeniSessionListCursorError,
+  OpenGeniSetupError,
   OpenGeniStreamError,
+  OpenGeniToolCallError,
+  OpenGeniToolReapprovalRequiredError,
+  OpenGeniToolsClient,
+  formatErrorMessage,
   isRetryableStreamError,
+  parseDeprecationNotice,
   resolveWorkspaceVoiceInputEnabled
 };
 //# sourceMappingURL=core.js.map

package/dist/deprecation.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Deprecation notices advertised by the Opengeni API.
+ *
+ * Per the public API compatibility policy, a route whose behaviour is scheduled
+ * for removal answers with the standard `Deprecation` (RFC 9745) and `Sunset`
+ * (RFC 8594) headers plus `Link: <notes>; rel="deprecation"`. The client
+ * surfaces them through `OpenGeniClientOptions.onDeprecation`, or by default
+ * as a one-time `console.warn` per route, so an integrator pinned to an older
+ * SDK learns about a removal well before it happens.
+ */
+export type OpenGeniDeprecationNotice = {
+    /** Request method, upper case. */
+    method: string;
+    /** Request path with ids collapsed (`/v1/workspaces/:id/...`), stable per route. */
+    route: string;
+    /** Exact request path. */
+    path: string;
+    /** When the deprecation was announced, if the header carried a date. */
+    deprecatedAt: Date | null;
+    /** Earliest removal on the server, if advertised. */
+    sunset: Date | null;
+    /** Migration notes (`rel="deprecation"`), if advertised. */
+    link: string | null;
+    /** Replacement (`rel="successor-version"`), if advertised. */
+    successor: string | null;
+};
+/** `false` silences notices; a function receives each route's notice once per client. */
+export type OpenGeniDeprecationHandler = (notice: OpenGeniDeprecationNotice) => void;
+type HeaderBag = {
+    get(name: string): string | null;
+};
+/** Read a deprecation notice from response headers; `null` when none is advertised. */
+export declare function parseDeprecationNotice(method: string, url: string, headers: HeaderBag): OpenGeniDeprecationNotice | null;
+/** The default handler: one `console.warn` per route per process. */
+export declare function warnDeprecationOnce(notice: OpenGeniDeprecationNotice): void;
+type FetchFunction<R extends {
+    headers: HeaderBag;
+}> = (input: string | URL | Request, init?: RequestInit) => Promise<R>;
+/**
+ * Wrap a fetch implementation so every response is inspected for a deprecation
+ * notice. The handler runs at most once per route for this wrapper and never
+ * affects the request: a throwing handler is swallowed.
+ */
+export declare function withDeprecationNotices<R extends {
+    headers: HeaderBag;
+}>(fetchImpl: FetchFunction<R>, handler: OpenGeniDeprecationHandler | false | undefined): FetchFunction<R>;
+export {};

package/dist/document-authority-client.d.ts

@@ -1,13 +1,35 @@
+import type { CompanyBrainOkfDownload, CompanyBrainOkfPackage } from "./company-brain.js";
 import { OpenGeniClient as OpenGeniCoreClient } from "./client.js";
-import type { DocumentAuthorityReclassification, DocumentDefaultCollectionBackfill, DocumentDefaultCollectionBackfillAudit, GetDocumentDefaultCollectionBackfillAuditOptions, ListDocumentAuthorityReclassificationsOptions, ListDocumentAuthorityReclassificationsResponse, ListDocumentDefaultCollectionBackfillRunsResponse, ListOrganizationDocumentAuthorityReclassificationsResponse, ReclassifyDocumentAuthorityRequest, RunDocumentDefaultCollectionBackfillRequest } from "./types.js";
+import type { ApiKey, UpdateOrganizationApiKeyRequest, Document, IssueUserResourceGrantRequest, UserResourceGrantMutationResponse, DocumentBase, FileDownloadUrlResponse, DocumentAuthorityReclassification, DocumentDefaultCollectionBackfill, DocumentDefaultCollectionBackfillAudit, GetDocumentDefaultCollectionBackfillAuditOptions, ListDocumentAuthorityReclassificationsOptions, ListDocumentAuthorityReclassificationsResponse, ListDocumentDefaultCollectionBackfillRunsResponse, ListOrganizationDocumentAuthorityReclassificationsResponse, ReclassifyDocumentAuthorityRequest, RunDocumentDefaultCollectionBackfillRequest } from "./types.js";
 /**
- * Operator-only Document authority and tenancy-backfill surface.
+ * Operator-only authority administration and Document tenancy-backfill surface.
  *
  * The public root and legacy `core` clients extend this class for compatibility.
  * Browser consoles that import `@opengeni/sdk/browser` do not retain these
  * methods or their routes.
  */
 export declare class OpenGeniDocumentAuthorityClient extends OpenGeniCoreClient {
+    /** Read organization-key metadata and policy; never returns the secret token. */
+    getOrganizationApiKey(organizationId: string, apiKeyId: string): Promise<ApiKey>;
+    /** Update metadata or replace the policy. Policy narrowing applies on the next request. */
+    updateOrganizationApiKey(organizationId: string, apiKeyId: string, request: UpdateOrganizationApiKeyRequest): Promise<ApiKey>;
+    /** Issue an exact-session or standing personal-resource grant. */
+    issueUserResourceGrant(workspaceId: string, authorityId: string, request: IssueUserResourceGrantRequest): Promise<UserResourceGrantMutationResponse>;
+    listDocumentBases(workspaceId: string): Promise<DocumentBase[]>;
+    /**
+     * List every Document the current human can manage from this workspace,
+     * including portable personal and organization-scoped Documents whose
+     * immutable ingestion workspace is different.
+     */
+    listAccessibleDocuments(workspaceId: string): Promise<Document[]>;
+    /** Mint a source-file URL through the Document's effective authority. */
+    createDocumentOriginalFileDownloadUrl(workspaceId: string, documentId: string): Promise<FileDownloadUrlResponse>;
+    /** Retry indexing for a failed document. */
+    reindexDocument(workspaceId: string, baseId: string, documentId: string): Promise<Document>;
+    /** Permission-filtered Company Brain package with authorized guidance bodies. */
+    getCompanyBrain(workspaceId: string): Promise<CompanyBrainOkfPackage>;
+    /** Download the deterministic Markdown/YAML Company Brain package. */
+    exportCompanyBrainOkf(workspaceId: string): Promise<CompanyBrainOkfDownload>;
     /**
      * Atomically reclassify a Document's authority and every indexed chunk.
      * The operation is replay-safe and rejects a stale expected authority tuple.

package/dist/document-authority.js

@@ -1,10 +1,12 @@
 import {
   OpenGeniDocumentAuthorityClient
-} from "./chunk-BESZFWMU.js";
-import "./chunk-GY6RQPCG.js";
-import "./chunk-E5BNEG2D.js";
-import "./chunk-QTBAMHEF.js";
-import "./chunk-OO5LPTO7.js";
+} from "./chunk-OI5YLASH.js";
+import "./chunk-S2NLS3ES.js";
+import "./chunk-X5ITQVXE.js";
+import "./chunk-4AHR4KGA.js";
+import "./chunk-NCU5OAN7.js";
+import "./chunk-YJCHB7R3.js";
+import "./chunk-7EWT3PV6.js";
 export {
   OpenGeniDocumentAuthorityClient
 };

package/dist/editable-artifacts/index.d.ts

@@ -13,7 +13,7 @@ export { EditableArtifactSyncPool } from "./pool.js";
 export type { EditableArtifactSyncControllerFactory, EditableArtifactSyncLease } from "./pool.js";
 export { createEditableArtifactSession } from "./session.js";
 export type { CreateEditableArtifactSessionOptions, ApplySerializedArtifactCommandsOptions, ApplySpreadsheetCommandsOptions, CreateDocumentParagraphInput, CreateDocumentParagraphResult, CreatePresentationSlideInput, CreatePresentationSlideResult, CreateSpreadsheetSheetInput, CreateSpreadsheetSheetResult, EditableArtifactSession, EditableSpreadsheetMetadataListener, EditableSpreadsheetViewportListener, EditableSpreadsheetViewportSubscriptionOptions, } from "./session.js";
-export type { EditableArtifactBootstrap, EditableArtifactBlockedPending, EditableArtifactCausalEntry, EditableArtifactCausalFrontier, EditableArtifactCommittedTransaction, EditableArtifactId, EditableArtifactModality, EditableArtifactLiveClose, EditableArtifactLiveConnection, EditableArtifactLiveLimits, EditableArtifactLiveMessage, EditableArtifactPendingTransaction, EditableArtifactSerializedCommittedTransaction, EditableArtifactSerializedModality, EditableArtifactSerializedPendingTransaction, EditableArtifactSerializedSnapshot, EditableArtifactReplayPage, EditableArtifactSnapshot, EditableArtifactSpreadsheetCommittedTransaction, EditableArtifactSpreadsheetPendingTransaction, EditableArtifactSpreadsheetSnapshot, EditableArtifactStoredReplica, EditableArtifactSubmitReceipt, EditableArtifactSyncListener, EditableArtifactSyncScheduler, EditableArtifactSyncState, EditableArtifactSyncTicket, EditableArtifactSyncTransport, EditableArtifactSyncView, EditableArtifactWorkerKernel, EditableDocumentProjection, EditableDocumentQuery, EditablePresentationProjection, EditablePresentationQuery, EditablePresentationEditorSlideProjection, EditablePresentationEditorSlideQuery, EditablePresentationSlideCatalogProjection, EditablePresentationSlideCatalogQuery, EditableSpreadsheetCellValue, EditableSpreadsheetFormulaError, EditableSpreadsheetMetadataProjection, EditableSpreadsheetMetadataQuery, EditableSpreadsheetProjectedCell, EditableSpreadsheetSheetMetadata, EditableSpreadsheetUsedBounds, EditableSpreadsheetViewportProjection, EditableSpreadsheetViewportQuery, } from "./types.js";
+export type { EditableArtifactBootstrap, EditableArtifactBlockedPending, EditableArtifactCausalEntry, EditableArtifactCausalFrontier, EditableArtifactCommittedTransaction, EditableArtifactId, EditableArtifactModality, EditableArtifactLiveClose, EditableArtifactLiveConnection, EditableArtifactLiveLimits, EditableArtifactLiveMessage, EditableArtifactPendingTransaction, EditableArtifactSerializedCommittedTransaction, EditableArtifactSerializedModality, EditableArtifactSerializedPendingTransaction, EditableArtifactSerializedSnapshot, EditableArtifactReplayPage, EditableArtifactSnapshot, EditableArtifactSpreadsheetCommittedTransaction, EditableArtifactSpreadsheetPendingTransaction, EditableArtifactSpreadsheetSnapshot, EditableArtifactStoredReplica, EditableArtifactSubmitReceipt, EditableArtifactSyncListener, EditableArtifactSyncScheduler, EditableArtifactSyncState, EditableArtifactSyncTicket, EditableArtifactSyncTransport, EditableArtifactSyncView, EditableArtifactWorkerKernel, EditableDocumentProjection, EditableDocumentQuery, EditablePresentationProjection, EditablePresentationQuery, EditablePresentationEditorSlideProjection, EditablePresentationEditorSlideQuery, EditablePresentationSlideCatalogProjection, EditablePresentationSlideCatalogQuery, EditableSpreadsheetCellValue, EditableSpreadsheetDimensions, EditableSpreadsheetFormulaError, EditableSpreadsheetMetadataProjection, EditableSpreadsheetMetadataQuery, EditableSpreadsheetProjectedCell, EditableSpreadsheetSheetMetadata, EditableSpreadsheetUsedBounds, EditableSpreadsheetViewportProjection, EditableSpreadsheetViewportQuery, } from "./types.js";
 export { ArtifactWorkerClientError, createBrowserEditableArtifactWorkerKernel, } from "./worker/browser-client.js";
 export type { ArtifactWorkerClientEndpoint, ArtifactWorkerClientErrorEvent, ArtifactWorkerClientMessageEvent, BrowserEditableArtifactWorkerKernel, CreateBrowserEditableArtifactWorkerKernelOptions, } from "./worker/browser-client.js";
 export { SPREADSHEET_ARTIFACT_COMMAND_VERSION, editableArtifactStableId, spreadsheetSheetId, type SpreadsheetArtifactCommandBatch, type SpreadsheetCellInput, type SpreadsheetSheetGeneration, } from "@opengeni/contracts/spreadsheet-artifact-commands";

package/dist/editable-artifacts/types.d.ts

@@ -148,7 +148,15 @@ export type EditableSpreadsheetProjectedCell = Readonly<{
  * Immutable projection of one exact speculative kernel revision. Cells are
  * sparse, strictly row-major, unique, and all inside the requested rectangle.
  */
-export type EditableSpreadsheetViewportProjection = Readonly<{
+export type EditableSpreadsheetDimensions = Readonly<{
+    /** Integer CSS pixels. Present when the kernel models dimensions. */
+    defaultRowHeight?: number;
+    defaultColumnWidth?: number;
+    /** Sorted sparse absolute zero-based indices and non-default pixel sizes. */
+    rowHeights?: readonly (readonly [number, number])[];
+    columnWidths?: readonly (readonly [number, number])[];
+}>;
+export type EditableSpreadsheetViewportProjection = EditableSpreadsheetDimensions & Readonly<{
     revision: bigint;
     sheetId: string;
     /** Creation operation that pins the live CRDT generation, if collaborative. */
@@ -167,7 +175,7 @@ export type EditableSpreadsheetUsedBounds = Readonly<{
     /** Inclusive maximum occupied column. */
     endColumn: number;
 }>;
-export type EditableSpreadsheetSheetMetadata = Readonly<{
+export type EditableSpreadsheetSheetMetadata = EditableSpreadsheetDimensions & Readonly<{
     sheetId: string;
     generationId: string | null;
     name: string;
@@ -403,6 +411,8 @@ export type EditableArtifactSyncView = {
     writable: boolean;
     pendingTransactions: number;
     blockedPending: readonly EditableArtifactBlockedPending[];
+    /** A command barrier independent of the artifact's edit permission. */
+    authoringBlockedReason?: "pending_conflict" | "prior_writer" | undefined;
     queuedMessages: number;
     reconnectAttempt: number;
     lastError: Error | null;

package/dist/editable-artifacts.js

@@ -18,7 +18,7 @@ import {
 import {
   OPENGENI_API_CONTRACT_HEADER,
   OPENGENI_API_CONTRACT_REVISION
-} from "./chunk-E5BNEG2D.js";
+} from "./chunk-NCU5OAN7.js";
 
 // src/editable-artifacts/controller.ts
 import {
@@ -1562,6 +1562,10 @@ var EditableArtifactSyncControllerImpl = class {
     this.rejectLiveWaiters(new Error("artifact sync controller closed"));
   }
   getView() {
+    const blockedPending = this.allBlockedPending();
+    const authoringBlockedReason = this.modality !== "spreadsheet" && blockedPending.length > 0 ? "pending_conflict" : this.orderedPending().some(
+      (transaction) => transaction.replicaId !== this.writerReplicaId
+    ) ? "prior_writer" : void 0;
     return {
       artifactId: this.artifactId,
       modality: this.modality,
@@ -1570,7 +1574,8 @@ var EditableArtifactSyncControllerImpl = class {
       headSequence: this.headSequence,
       writable: this.writable,
       pendingTransactions: this.pending.size,
-      blockedPending: this.allBlockedPending(),
+      blockedPending,
+      authoringBlockedReason,
       queuedMessages: this.liveQueue.length,
       reconnectAttempt: this.reconnectAttempt,
       lastError: this.lastError
@@ -1847,8 +1852,9 @@ var EditableArtifactSyncControllerImpl = class {
     let stateHash = stored.snapshot.stateHash;
     let causalFrontier = stored.snapshot.modality === "spreadsheet" ? stored.snapshot.causalFrontier : null;
     let nativeRevision = stored.snapshot.modality === "spreadsheet" ? null : stored.snapshot.nativeRevision;
+    const retainedAcceptances = [];
     for (const transaction of stored.tail) {
-      validateCommittedTransaction(
+      const embeddedPending = validateCommittedTransaction(
         transaction,
         this.artifactId,
         this.modality,
@@ -1861,6 +1867,12 @@ var EditableArtifactSyncControllerImpl = class {
       requireStateHash(transaction.priorStateHash, stateHash, "retained transaction prior state");
       const applied = await this.kernel.applyRecovered(transaction);
       requireStateHash(applied.stateHash, transaction.stateHash, "retained transaction");
+      if (embeddedPending) {
+        const pending = this.pending.get(embeddedPending.clientTransactionId);
+        if (pending?.requestHash === embeddedPending.requestHash && bytesEqual2(pending.intentBytes, embeddedPending.intentBytes)) {
+          retainedAcceptances.push({ transaction, pending: embeddedPending });
+        }
+      }
       cursor = transaction.endSequence;
       stateHash = transaction.stateHash;
       if (transaction.modality === "spreadsheet") {
@@ -1893,6 +1905,10 @@ var EditableArtifactSyncControllerImpl = class {
     this.retainedTailTransactions = stored.tail.length;
     this.cursor = cursor;
     this.headSequence = cursor;
+    for (const { transaction, pending } of retainedAcceptances) {
+      this.recordAcceptedMappingIdentity(transaction.transactionId, pending);
+      await this.settlePending(transaction, true);
+    }
   }
   async run() {
     await this.initialize();