@superdoc/sdk 2.26.0-next.1 → 2.26.0-next.16

package/dist/runtime/host.js

@@ -5,11 +5,10 @@ import { SdkStateDirectory } from './state-directory.js';
 import { registerMutationRevision } from './document-evidence.js';
 import { CONTRACT } from '../generated/contract.js';
 import { SDK_POLICY } from './sdk-policy.js';
-import { DOCUMENT_RPC_DEFAULT_CHANGE_MODE_FEATURE, DOCUMENT_RPC_REQUEST_TIMEOUT_FEATURE, DOCUMENT_RPC_REPLACE_FILE_FEATURE, DOCUMENT_RPC_SOURCE_SAVE_FEATURE, buildDocumentInvokeParams, buildDocumentOpenParams, canOpenWithDocumentRpc, documentRpcRequestSupportsResponseTimeout, documentRpcEnabled, mapDocumentLifecycleResult, mapDocumentOpenResult, mapDocumentReplaceFileResult, supportsDocumentRpc, } from './document-rpc.js';
 const HOST_PROTOCOL_VERSION = SDK_POLICY.protocolVersion;
 const CLI_HOST_REQUIRED_FEATURES = SDK_POLICY.cliRequiredFeatures;
 export const COLLABORATION_AUTH_PER_OPEN_FEATURE = SDK_POLICY.features.collaborationAuthPerOpen;
-const DOCUMENT_HOST_REQUIRED_FEATURES = SDK_POLICY.documentRequiredFeatures;
+const HOST_REQUEST_TIMEOUT_FEATURE = SDK_POLICY.features.requestTimeout;
 const CHANGE_MODES = ['direct', 'tracked'];
 const FORWARD_HOST_STDERR = typeof process !== 'undefined' && typeof process.env?.SUPERDOC_DEBUG_TEXT_REWRITE === 'string'
     ? process.env.SUPERDOC_DEBUG_TEXT_REWRITE === '1'
@@ -36,6 +35,30 @@ export function mapCliInvocationResult(operation, value) {
     const extracted = value[envelopeKey];
     return extracted === undefined ? value : extracted;
 }
+export function mapDocumentReplaceFileResult(response, sessionId) {
+    if (typeof response !== 'object' || response == null || Array.isArray(response)) {
+        throw new SuperDocCliError('Host returned invalid document.replaceFile result.', {
+            code: 'HOST_PROTOCOL_ERROR',
+            details: { result: response },
+        });
+    }
+    const record = response;
+    if (record.sessionId !== sessionId ||
+        record.replaced !== true ||
+        typeof record.byteLength !== 'number' ||
+        typeof record.revision !== 'string') {
+        throw new SuperDocCliError('Host returned invalid document.replaceFile session metadata.', {
+            code: 'HOST_PROTOCOL_ERROR',
+            details: { expectedSessionId: sessionId, result: response },
+        });
+    }
+    return {
+        contextId: sessionId,
+        runtime: 'v2',
+        replaced: true,
+        document: { byteLength: record.byteLength, revision: record.revision },
+    };
+}
 /**
  * Builds the argv passed to `spawn` for `superdoc host --stdio`. Propagates
  * `requestTimeoutMs` to the host via `--request-timeout-ms`, since the SDK
@@ -50,9 +73,6 @@ export function buildHostSpawnArgs(prefixArgs, options) {
     }
     return args;
 }
-export function buildDocumentHostSpawnArgs(prefixArgs) {
-    return [...prefixArgs];
-}
 /**
  * Computes the JS-side watchdog timeout for a single JSON-RPC request.
  *
@@ -78,12 +98,10 @@ export function resolveJsWatchdogTimeout(watchdogTimeoutMs, requestTimeoutMs, ti
     }
     return Math.max(watchdogTimeoutMs, HOST_DEFAULT_REQUEST_TIMEOUT_MS + WATCHDOG_HEADROOM_MS);
 }
-/** Transport for the legacy CLI host or the structured document host. */
 export class HostTransport {
     stateDirectory;
     stoppedChildren = new Map();
     hostBin;
-    processMode;
     env;
     startupTimeoutMs;
     shutdownTimeoutMs;
@@ -92,7 +110,6 @@ export class HostTransport {
     maxQueueDepth;
     defaultChangeMode;
     user;
-    documentRpcEnabled;
     child = null;
     stdoutBuffer = '';
     stdoutDataListener = null;
@@ -104,15 +121,10 @@ export class HostTransport {
     stopping = false;
     activeCalls = new Set();
     hostFeatures = new Set();
-    documentRpcSessions = new Set();
     cliLocalSessions = new Set();
-    dirtyDocumentRpcSessions = new Set();
-    documentRpcMutationStates = new Map();
-    indeterminateDiscardCloses = new Set();
     constructor(options) {
         this.stateDirectory = new SdkStateDirectory(options.stateDir);
         this.hostBin = options.hostBin;
-        this.processMode = options.processMode ?? 'cli';
         this.env = options.env;
         this.startupTimeoutMs = options.startupTimeoutMs ?? 5_000;
         this.shutdownTimeoutMs = options.shutdownTimeoutMs ?? 5_000;
@@ -127,17 +139,12 @@ export class HostTransport {
         }
         this.defaultChangeMode = options.defaultChangeMode ?? undefined;
         this.user = options.user;
-        this.documentRpcEnabled = this.processMode === 'document' || documentRpcEnabled(options.env);
     }
     async connect() {
         await this.runWhileActive(() => this.ensureConnected());
     }
     supportsDocumentFacts(sessionId) {
-        return (this.usesCliDocumentFacts(sessionId) ||
-            (this.documentRpcSessions.has(sessionId) &&
-                this.hostFeatures.has('document.currentRevision') &&
-                this.hostFeatures.has('document.executionFacts') &&
-                this.hostFeatures.has('document.mutationRevision')));
+        return this.usesCliDocumentFacts(sessionId);
     }
     usesCliDocumentFacts(sessionId) {
         return this.cliLocalSessions.has(sessionId) && this.hostFeatures.has('cli.invoke.localExecutionFacts');
@@ -155,18 +162,7 @@ export class HostTransport {
                     throw new SuperDocCliError('CLI returned an invalid execution revision.', { code: 'HOST_PROTOCOL_ERROR' });
                 return page.revision;
             }
-            if (!this.documentRpcSessions.has(sessionId) || !this.hostFeatures.has('document.currentRevision')) {
-                return undefined;
-            }
-            await this.ensureConnected();
-            const revision = await this.sendJsonRpcRequest('document.currentRevision', { sessionId }, this.resolveWatchdogTimeout(undefined), { requestTimeoutMs: this.resolveDocumentRequestTimeout(undefined) });
-            if (typeof revision !== 'string' || revision.trim().length === 0 || revision === 'unknown') {
-                throw new SuperDocCliError('Document host returned an invalid current revision.', {
-                    code: 'HOST_PROTOCOL_ERROR',
-                    details: { sessionId },
-                });
-            }
-            return revision;
+            return undefined;
         });
     }
     async dispose() {
@@ -201,16 +197,6 @@ export class HostTransport {
             await this.stateDirectory.dispose();
             return;
         }
-        try {
-            await this.reconcileIndeterminateDiscardCloses();
-            await this.persistDirtyDocumentRpcSessions();
-        }
-        catch (error) {
-            if (!this.child && error instanceof SuperDocCliError) {
-                this.terminalDisposalError = error;
-            }
-            throw error;
-        }
         const child = this.child;
         try {
             await this.sendJsonRpcRequest('host.shutdown', {}, this.shutdownTimeoutMs);
@@ -236,29 +222,14 @@ export class HostTransport {
     async replaceFile(sessionId, path, options = {}) {
         return this.runWhileActive(async () => {
             await this.ensureConnected();
-            if (!this.hostFeatures.has(DOCUMENT_RPC_REPLACE_FILE_FEATURE)) {
+            if (!this.hostFeatures.has(SDK_POLICY.features.replaceFile)) {
                 throw new SuperDocCliError('The connected host does not support document replacement.', {
                     code: 'CAPABILITY_UNSUPPORTED',
-                    details: { feature: DOCUMENT_RPC_REPLACE_FILE_FEATURE },
+                    details: { feature: SDK_POLICY.features.replaceFile },
                 });
             }
-            const tracksDirectSession = this.documentRpcSessions.has(sessionId);
-            if (tracksDirectSession)
-                this.beginDocumentRpcMutation(sessionId);
-            try {
-                const response = await this.sendJsonRpcRequest(DOCUMENT_RPC_REPLACE_FILE_FEATURE, { sessionId, path }, this.resolveWatchdogTimeout(options.timeoutMs));
-                const result = mapDocumentReplaceFileResult(response, sessionId);
-                if (tracksDirectSession)
-                    this.settleDocumentRpcMutation(sessionId, 'applied');
-                return result;
-            }
-            catch (error) {
-                if (tracksDirectSession) {
-                    const indeterminate = error instanceof SuperDocCliError && ['TIMEOUT', 'HOST_TIMEOUT', 'HOST_DISCONNECTED'].includes(error.code);
-                    this.settleDocumentRpcMutation(sessionId, indeterminate ? 'indeterminate' : 'not-applied');
-                }
-                throw error;
-            }
+            const response = await this.sendJsonRpcRequest(SDK_POLICY.features.replaceFile, { sessionId, path }, this.resolveWatchdogTimeout(options.timeoutMs));
+            return mapDocumentReplaceFileResult(response, sessionId);
         });
     }
     async invokeWhileActive(operation, params, options) {
@@ -269,12 +240,6 @@ export class HostTransport {
                     code: 'INVALID_ARGUMENT',
                 });
             }
-            if (this.processMode !== 'cli') {
-                throw new SuperDocCliError('Per-open collaboration authentication is not supported by the standalone document host.', {
-                    code: 'CAPABILITY_UNSUPPORTED',
-                    details: { feature: COLLABORATION_AUTH_PER_OPEN_FEATURE },
-                });
-            }
         }
         await this.ensureConnected();
         if (collaborationAuth !== undefined && !this.hostFeatures.has(COLLABORATION_AUTH_PER_OPEN_FEATURE)) {
@@ -283,88 +248,8 @@ export class HostTransport {
                 details: { feature: COLLABORATION_AUTH_PER_OPEN_FEATURE },
             });
         }
-        const shouldOpenThroughCliTimeoutFallback = this.processMode === 'cli' &&
-            (this.requestTimeoutMs !== undefined ||
-                (options.timeoutMs !== undefined && !this.hostFeatures.has(DOCUMENT_RPC_REQUEST_TIMEOUT_FEATURE)));
-        if (this.documentRpcEnabled &&
-            supportsDocumentRpc(this.hostFeatures) &&
-            (this.defaultChangeMode === undefined || this.hostFeatures.has(DOCUMENT_RPC_DEFAULT_CHANGE_MODE_FEATURE)) &&
-            operation.operationId === 'doc.open' &&
-            canOpenWithDocumentRpc(params, options) &&
-            !shouldOpenThroughCliTimeoutFallback) {
-            const opened = buildDocumentOpenParams(params, this.user, this.defaultChangeMode);
-            const requestTimeoutMs = this.resolveDocumentRequestTimeout(options.timeoutMs);
-            const response = await this.sendJsonRpcRequest('document.open', opened.params, this.resolveWatchdogTimeout(options.timeoutMs), { requestTimeoutMs });
-            const result = mapDocumentOpenResult(response, opened.sessionId, params.doc);
-            this.documentRpcSessions.add(opened.sessionId);
-            this.indeterminateDiscardCloses.delete(opened.sessionId);
-            return result;
-        }
         const sessionId = typeof params.sessionId === 'string' ? params.sessionId : undefined;
-        if (sessionId !== undefined && this.documentRpcSessions.has(sessionId)) {
-            const request = buildDocumentInvokeParams(sessionId, operation, params, options, this.hostFeatures);
-            const supportsResponseTimeout = documentRpcRequestSupportsResponseTimeout(operation, request);
-            const requestTimeoutMs = supportsResponseTimeout
-                ? this.resolveDocumentRequestTimeout(options.timeoutMs)
-                : undefined;
-            const documentOperation = operation;
-            const requestOptions = typeof request.params.options === 'object' &&
-                request.params.options !== null &&
-                !Array.isArray(request.params.options)
-                ? request.params.options
-                : undefined;
-            const tracksMutation = request.method === 'document.invoke' && documentOperation.mutates === true && requestOptions?.dryRun !== true;
-            const includeRevision = request.method === 'document.invoke' &&
-                documentOperation.mutates === true &&
-                this.hostFeatures.has('document.mutationRevision');
-            if (tracksMutation)
-                this.beginDocumentRpcMutation(sessionId);
-            let result;
-            try {
-                const response = await this.sendJsonRpcRequest(request.method, { ...request.params, ...(includeRevision ? { includeRevision: true } : {}) }, this.resolveWatchdogTimeout(options.timeoutMs), { requestTimeoutMs });
-                result = mapDocumentLifecycleResult(operation.operationId, includeRevision ? response.result : response, sessionId, operation.operationId === 'doc.save' ? request.params.path === undefined : undefined);
-                if (includeRevision)
-                    registerMutationRevision(result, response.revision);
-            }
-            catch (error) {
-                if (tracksMutation) {
-                    const indeterminate = error instanceof SuperDocCliError && ['TIMEOUT', 'HOST_TIMEOUT', 'HOST_DISCONNECTED'].includes(error.code);
-                    this.settleDocumentRpcMutation(sessionId, indeterminate ? 'indeterminate' : 'not-applied');
-                }
-                if (operation.operationId === 'doc.close' &&
-                    request.params.discard === true &&
-                    error instanceof SuperDocCliError &&
-                    error.code === 'TIMEOUT') {
-                    this.indeterminateDiscardCloses.add(sessionId);
-                }
-                throw error;
-            }
-            if (tracksMutation) {
-                const failedReceipt = typeof result === 'object' &&
-                    result !== null &&
-                    !Array.isArray(result) &&
-                    result.success === false;
-                this.settleDocumentRpcMutation(sessionId, failedReceipt ? 'not-applied' : 'applied');
-            }
-            if (operation.operationId === 'doc.close') {
-                this.documentRpcSessions.delete(sessionId);
-                this.clearDirtyDocumentRpcSession(sessionId);
-                this.indeterminateDiscardCloses.delete(sessionId);
-            }
-            else if (operation.operationId === 'doc.save') {
-                if (request.params.mode === undefined || request.params.mode === 'review-preserving') {
-                    this.markDocumentRpcSessionSaved(sessionId);
-                }
-            }
-            return result;
-        }
-        if (this.processMode === 'document') {
-            throw new SuperDocCliError(`Standalone document host does not support ${operation.operationId} through structured RPC v0.`, {
-                code: 'DOCUMENT_RPC_INPUT_UNSUPPORTED',
-                details: { operationId: operation.operationId },
-            });
-        }
-        const supportsRequestTimeoutMetadata = this.hostFeatures.has(DOCUMENT_RPC_REQUEST_TIMEOUT_FEATURE);
+        const supportsRequestTimeoutMetadata = this.hostFeatures.has(HOST_REQUEST_TIMEOUT_FEATURE);
         const cliHostRequestTimeoutMs = this.requestTimeoutMs ?? HOST_DEFAULT_REQUEST_TIMEOUT_MS;
         if (!supportsRequestTimeoutMetadata &&
             options.timeoutMs !== undefined &&
@@ -372,7 +257,7 @@ export class HostTransport {
             throw new SuperDocCliError(`CLI host cannot honor timeoutMs=${options.timeoutMs} above its ${cliHostRequestTimeoutMs}ms request ceiling.`, {
                 code: 'DOCUMENT_RPC_INPUT_UNSUPPORTED',
                 details: {
-                    feature: DOCUMENT_RPC_REQUEST_TIMEOUT_FEATURE,
+                    feature: HOST_REQUEST_TIMEOUT_FEATURE,
                     operationId: operation.operationId,
                     timeoutMs: options.timeoutMs,
                     hostRequestTimeoutMs: cliHostRequestTimeoutMs,
@@ -455,9 +340,7 @@ export class HostTransport {
     }
     async startHostProcess() {
         const { command, prefixArgs } = resolveInvocation(this.hostBin);
-        const args = this.processMode === 'document'
-            ? buildDocumentHostSpawnArgs(prefixArgs)
-            : buildHostSpawnArgs(prefixArgs, { requestTimeoutMs: this.requestTimeoutMs });
+        const args = buildHostSpawnArgs(prefixArgs, { requestTimeoutMs: this.requestTimeoutMs });
         await this.waitForStoppedChildren();
         const env = { ...process.env, ...this.env };
         env.SUPERDOC_CLI_STATE_DIR = await this.stateDirectory.prepare(env);
@@ -492,7 +375,7 @@ export class HostTransport {
         child.on('close', (code, signal) => {
             if (this.child !== child)
                 return;
-            if (this.stopping && this.dirtyDocumentRpcSessions.size === 0) {
+            if (this.stopping) {
                 this.cleanupProcess(null);
                 return;
             }
@@ -543,13 +426,7 @@ export class HostTransport {
                 details: { features },
             });
         }
-        const requiredFeatures = this.processMode === 'document'
-            ? [
-                ...DOCUMENT_HOST_REQUIRED_FEATURES,
-                ...(this.defaultChangeMode === undefined ? [] : [DOCUMENT_RPC_DEFAULT_CHANGE_MODE_FEATURE]),
-                ...(this.requestTimeoutMs === undefined ? [] : [DOCUMENT_RPC_REQUEST_TIMEOUT_FEATURE]),
-            ]
-            : CLI_HOST_REQUIRED_FEATURES;
+        const requiredFeatures = CLI_HOST_REQUIRED_FEATURES;
         for (const requiredFeature of requiredFeatures) {
             if (!features.includes(requiredFeature)) {
                 throw new SuperDocCliError(`Host does not support required feature: ${requiredFeature}`, {
@@ -565,78 +442,6 @@ export class HostTransport {
     resolveWatchdogTimeout(timeoutMsOverride) {
         return resolveJsWatchdogTimeout(this.watchdogTimeoutMs, this.requestTimeoutMs, timeoutMsOverride);
     }
-    resolveDocumentRequestTimeout(timeoutMsOverride) {
-        const requestTimeoutMs = timeoutMsOverride ?? this.requestTimeoutMs;
-        if (requestTimeoutMs === undefined)
-            return undefined;
-        if (this.hostFeatures.has(DOCUMENT_RPC_REQUEST_TIMEOUT_FEATURE))
-            return requestTimeoutMs;
-        if (this.processMode === 'cli' && timeoutMsOverride === undefined)
-            return undefined;
-        throw new SuperDocCliError(`Structured document RPC host does not support ${DOCUMENT_RPC_REQUEST_TIMEOUT_FEATURE}.`, {
-            code: 'DOCUMENT_RPC_INPUT_UNSUPPORTED',
-            details: { feature: DOCUMENT_RPC_REQUEST_TIMEOUT_FEATURE },
-        });
-    }
-    beginDocumentRpcMutation(sessionId) {
-        const state = this.documentRpcMutationStates.get(sessionId) ?? {
-            confirmedDirty: this.dirtyDocumentRpcSessions.has(sessionId),
-            pendingCount: 0,
-        };
-        state.pendingCount += 1;
-        this.documentRpcMutationStates.set(sessionId, state);
-        this.dirtyDocumentRpcSessions.add(sessionId);
-    }
-    settleDocumentRpcMutation(sessionId, outcome) {
-        const state = this.documentRpcMutationStates.get(sessionId);
-        if (!state)
-            return;
-        state.pendingCount = Math.max(0, state.pendingCount - 1);
-        if (outcome !== 'not-applied')
-            state.confirmedDirty = true;
-        if (state.confirmedDirty || state.pendingCount > 0) {
-            this.dirtyDocumentRpcSessions.add(sessionId);
-            return;
-        }
-        this.clearDirtyDocumentRpcSession(sessionId);
-    }
-    clearDirtyDocumentRpcSession(sessionId) {
-        this.dirtyDocumentRpcSessions.delete(sessionId);
-        this.documentRpcMutationStates.delete(sessionId);
-    }
-    markDocumentRpcSessionSaved(sessionId) {
-        const state = this.documentRpcMutationStates.get(sessionId);
-        if (!state || state.pendingCount === 0) {
-            this.clearDirtyDocumentRpcSession(sessionId);
-            return;
-        }
-        state.confirmedDirty = false;
-        this.dirtyDocumentRpcSessions.add(sessionId);
-    }
-    async persistDirtyDocumentRpcSessions() {
-        if (this.dirtyDocumentRpcSessions.size === 0)
-            return;
-        if (!this.hostFeatures.has(DOCUMENT_RPC_SOURCE_SAVE_FEATURE)) {
-            throw new SuperDocCliError('Document host cannot persist dirty sessions during client disposal because it does not support source saves.', {
-                code: 'DOCUMENT_RPC_INPUT_UNSUPPORTED',
-                details: { feature: DOCUMENT_RPC_SOURCE_SAVE_FEATURE },
-            });
-        }
-        for (const sessionId of this.dirtyDocumentRpcSessions) {
-            const response = await this.sendJsonRpcRequest('document.save', { sessionId }, this.resolveWatchdogTimeout(undefined));
-            mapDocumentLifecycleResult('doc.save', response, sessionId, true);
-            this.markDocumentRpcSessionSaved(sessionId);
-        }
-    }
-    async reconcileIndeterminateDiscardCloses() {
-        for (const sessionId of this.indeterminateDiscardCloses) {
-            const response = await this.sendJsonRpcRequest('document.close', { sessionId, discard: true }, this.resolveWatchdogTimeout(undefined));
-            mapDocumentLifecycleResult('doc.close', response, sessionId);
-            this.documentRpcSessions.delete(sessionId);
-            this.clearDirtyDocumentRpcSession(sessionId);
-            this.indeterminateDiscardCloses.delete(sessionId);
-        }
-    }
     async sendJsonRpcRequest(method, params, watchdogTimeoutMs, metadata = {}) {
         const child = this.child;
         if (!child || !child.stdin.writable) {
@@ -810,17 +615,7 @@ export class HostTransport {
         this.cleanupProcess(error);
     }
     cleanupProcess(error) {
-        if (error && this.dirtyDocumentRpcSessions.size > 0 && !this.terminalDisposalError) {
-            this.terminalDisposalError = new SuperDocCliError('Document host disconnected before dirty sessions could be persisted.', {
-                code: 'HOST_DISCONNECTED',
-                details: { causeCode: error.code, causeDetails: error.details },
-            });
-        }
         this.hostFeatures.clear();
-        this.documentRpcSessions.clear();
-        this.dirtyDocumentRpcSessions.clear();
-        this.documentRpcMutationStates.clear();
-        this.indeterminateDiscardCloses.clear();
         const child = this.child;
         if (child) {
             if (this.stdoutDataListener)

package/dist/runtime/process.cjs

@@ -5,46 +5,20 @@ var os = require('node:os');
 var path = require('node:path');
 var host = require('./host.cjs');
 var embeddedCli = require('./embedded-cli.cjs');
-var embeddedDocumentHost = require('./embedded-document-host.cjs');
 var debugTrace = require('./debug-trace.cjs');
 var errors = require('./errors.cjs');
 
 function resolveRuntimeProcess(options = {}, embedded = {
     cli: embeddedCli.resolveEmbeddedCliBinary,
-    documentHost: embeddedDocumentHost.resolveEmbeddedDocumentHostBinary,
 }) {
-    const configuredDocumentHostPath = options.documentHostPath;
-    if (configuredDocumentHostPath !== undefined && configuredDocumentHostPath.trim().length === 0) {
-        throw new errors.SuperDocCliError('documentHostPath must be a non-empty path.', {
-            code: 'INVALID_ARGUMENT',
-        });
-    }
-    const configuredDocumentHostBin = options.env?.SUPERDOC_SDK_DOCUMENT_HOST_BIN ?? process.env.SUPERDOC_SDK_DOCUMENT_HOST_BIN;
-    const documentHostBin = configuredDocumentHostPath ??
-        (configuredDocumentHostBin === 'embedded' ? embedded.documentHost() : configuredDocumentHostBin);
-    if (documentHostBin !== undefined && documentHostBin.trim().length === 0) {
-        throw new errors.SuperDocCliError('SUPERDOC_SDK_DOCUMENT_HOST_BIN must be a non-empty path.', {
-            code: 'INVALID_ARGUMENT',
-        });
-    }
-    if (documentHostBin !== undefined) {
-        return { hostBin: documentHostBin, processMode: 'document' };
-    }
     return {
         hostBin: options.env?.SUPERDOC_CLI_BIN ?? process.env.SUPERDOC_CLI_BIN ?? embedded.cli(),
-        processMode: 'cli',
     };
 }
 function toSafeInvokeTraceOptions(options) {
     const { collaborationAuth: _collaborationAuth, ...traceOptions } = options;
     return traceOptions;
 }
-/**
- * Internal runtime that delegates operations to a persistent host transport.
- *
- * Uses the standalone document host when explicitly configured. Otherwise it
- * preserves the embedded CLI compatibility path.
- */
 class SuperDocRuntime {
     transport;
     constructor(options = {}) {

package/dist/runtime/process.d.ts

@@ -1,11 +1,9 @@
 import type { CollaborationAuth, DocumentRuntimeKind, DocOpenOptions, InvokeOptions, TransportInvokeOptions, OperationParamSpec, OperationSpec, RuntimeInvoker, SuperDocClientOptions } from './transport-common.js';
 type RuntimeProcessResolution = {
     hostBin: string;
-    processMode: 'cli' | 'document';
 };
 type EmbeddedRuntimeResolvers = {
     cli: () => string;
-    documentHost: () => string;
 };
 export type ReplaceFileSource = string | Uint8Array | ArrayBuffer;
 export interface ReplaceFileOptions {
@@ -22,12 +20,6 @@ export interface ReplaceFileResult {
 }
 export declare function resolveRuntimeProcess(options?: SuperDocClientOptions, embedded?: EmbeddedRuntimeResolvers): RuntimeProcessResolution;
 export declare function toSafeInvokeTraceOptions(options: TransportInvokeOptions): InvokeOptions;
-/**
- * Internal runtime that delegates operations to a persistent host transport.
- *
- * Uses the standalone document host when explicitly configured. Otherwise it
- * preserves the embedded CLI compatibility path.
- */
 export declare class SuperDocRuntime {
     private readonly transport;
     constructor(options?: SuperDocClientOptions);

package/dist/runtime/process.js

@@ -3,45 +3,19 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { HostTransport } from './host.js';
 import { resolveEmbeddedCliBinary } from './embedded-cli.js';
-import { resolveEmbeddedDocumentHostBinary } from './embedded-document-host.js';
 import { writeSdkDebugTrace } from './debug-trace.js';
 import { SuperDocCliError } from './errors.js';
 export function resolveRuntimeProcess(options = {}, embedded = {
     cli: resolveEmbeddedCliBinary,
-    documentHost: resolveEmbeddedDocumentHostBinary,
 }) {
-    const configuredDocumentHostPath = options.documentHostPath;
-    if (configuredDocumentHostPath !== undefined && configuredDocumentHostPath.trim().length === 0) {
-        throw new SuperDocCliError('documentHostPath must be a non-empty path.', {
-            code: 'INVALID_ARGUMENT',
-        });
-    }
-    const configuredDocumentHostBin = options.env?.SUPERDOC_SDK_DOCUMENT_HOST_BIN ?? process.env.SUPERDOC_SDK_DOCUMENT_HOST_BIN;
-    const documentHostBin = configuredDocumentHostPath ??
-        (configuredDocumentHostBin === 'embedded' ? embedded.documentHost() : configuredDocumentHostBin);
-    if (documentHostBin !== undefined && documentHostBin.trim().length === 0) {
-        throw new SuperDocCliError('SUPERDOC_SDK_DOCUMENT_HOST_BIN must be a non-empty path.', {
-            code: 'INVALID_ARGUMENT',
-        });
-    }
-    if (documentHostBin !== undefined) {
-        return { hostBin: documentHostBin, processMode: 'document' };
-    }
     return {
         hostBin: options.env?.SUPERDOC_CLI_BIN ?? process.env.SUPERDOC_CLI_BIN ?? embedded.cli(),
-        processMode: 'cli',
     };
 }
 export function toSafeInvokeTraceOptions(options) {
     const { collaborationAuth: _collaborationAuth, ...traceOptions } = options;
     return traceOptions;
 }
-/**
- * Internal runtime that delegates operations to a persistent host transport.
- *
- * Uses the standalone document host when explicitly configured. Otherwise it
- * preserves the embedded CLI compatibility path.
- */
 export class SuperDocRuntime {
     transport;
     constructor(options = {}) {

package/dist/runtime/sdk-policy.d.ts

@@ -1,21 +1,11 @@
 export declare const SDK_POLICY: {
     protocolVersion: string;
     cliRequiredFeatures: readonly string[];
-    documentRequiredFeatures: readonly string[];
-    documentRpcFeatures: readonly string[];
     features: {
         replaceFile: string;
-        defaultChangeMode: string;
-        sourceSave: string;
         requestTimeout: string;
         collaborationAuthPerOpen: string;
-        documentAuthor: string;
-        fullPreset?: string;
     };
-    documentOpenFields: readonly string[];
-    documentSaveFields: readonly string[];
-    documentOptionFields: readonly string[];
-    revisionPreflightOperations: readonly string[];
     operationParamAliases: Record<string, Readonly<Record<string, readonly string[]>>>;
     notifications: readonly string[];
     hostDefaultRequestTimeoutMs: number;

package/dist/runtime/sdk-version.generated.cjs

@@ -3,6 +3,6 @@
 // AUTO-GENERATED by scripts/embed-version.mjs — DO NOT EDIT.
 // Source of truth: package.json. Regenerated on every SDK build so the
 // SDK retains its own version identity when bundled into another package.
-const SDK_VERSION = '2.26.0-next.1';
+const SDK_VERSION = '2.26.0-next.16';
 
 exports.SDK_VERSION = SDK_VERSION;

package/dist/runtime/sdk-version.generated.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.26.0-next.1";
+export declare const SDK_VERSION = "2.26.0-next.16";

package/dist/runtime/sdk-version.generated.js

@@ -1,4 +1,4 @@
 // AUTO-GENERATED by scripts/embed-version.mjs — DO NOT EDIT.
 // Source of truth: package.json. Regenerated on every SDK build so the
 // SDK retains its own version identity when bundled into another package.
-export const SDK_VERSION = '2.26.0-next.1';
+export const SDK_VERSION = '2.26.0-next.16';

package/dist/runtime/transport-common.d.ts

@@ -49,14 +49,6 @@ export interface SuperDocClientOptions {
     /** Writable host state root. Takes precedence over SUPERDOC_CLI_STATE_DIR; persists after disposal. */
     stateDir?: string;
     env?: Record<string, string | undefined>;
-    /**
-     * Standalone document-host entry to use instead of the embedded CLI.
-     *
-     * The host-only path supports local lifecycle methods and generated Document
-     * API operations through structured RPC. Interface-only conveniences fail
-     * without CLI fallback.
-     */
-    documentHostPath?: string;
     /**
      * Default document engine for `client.open(...)`. Explicit `runtime` on an
      * individual open call takes precedence.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/sdk",
-  "version": "2.26.0-next.1",
+  "version": "2.26.0-next.16",
   "description": "Node SDK for SuperDoc, wrapping the SuperDoc CLI to read and edit .docx files from JavaScript and TypeScript.",
   "private": false,
   "license": "AGPL-3.0",
@@ -38,11 +38,11 @@
     "typescript": "^5.9.2"
   },
   "optionalDependencies": {
-    "@superdoc/sdk-darwin-arm64": "2.26.0-next.1",
-    "@superdoc/sdk-darwin-x64": "2.26.0-next.1",
-    "@superdoc/sdk-linux-x64": "2.26.0-next.1",
-    "@superdoc/sdk-linux-arm64": "2.26.0-next.1",
-    "@superdoc/sdk-windows-x64": "2.26.0-next.1"
+    "@superdoc/sdk-darwin-arm64": "2.26.0-next.16",
+    "@superdoc/sdk-darwin-x64": "2.26.0-next.16",
+    "@superdoc/sdk-linux-x64": "2.26.0-next.16",
+    "@superdoc/sdk-linux-arm64": "2.26.0-next.16",
+    "@superdoc/sdk-windows-x64": "2.26.0-next.16"
   },
   "publishConfig": {
     "access": "public"
@@ -53,7 +53,7 @@
     "typecheck": "tsc --noEmit",
     "typecheck:consumer": "tsc --noEmit --strict --skipLibCheck --target ES2022 --module NodeNext --moduleResolution NodeNext ../../../../tests/consumer-typecheck/src/sdk-per-open-collaboration-auth.mts ../../../../tests/consumer-typecheck/src/sdk-replace-file.mts ../../../../tests/consumer-typecheck/src/sdk-retained-paragraph.mts ../../../../tests/consumer-typecheck/src/sdk-state-directory.mts ../../../../tests/consumer-typecheck/src/sdk-agent-evidence.mts ../../../../tests/consumer-typecheck/src/sdk-custom-actions.mts ../../../../tests/consumer-typecheck/src/sd4807-sdk-inspect.mts ../../../../tests/consumer-typecheck/src/sdk-tracked-only-policy.mts ../../../../tests/consumer-typecheck/src/sdk-tracked-review-route.mts ../../../../tests/consumer-typecheck/src/sd5266-sdk-placeholder-null.mts ../../../../tests/consumer-typecheck/src/sdk-schema-types.mts",
     "test:agent-actions": "bun test src/__tests__/actions.test.ts src/__tests__/agent-runtime.test.ts src/__tests__/execution-context.test.ts src/__tests__/custom-actions.test.ts src/__tests__/textbox-snapshot.test.ts",
-    "test:document-host": "bun test src/__tests__/diff-direct-styles.e2e.test.ts src/__tests__/default-cli-optimization.e2e.test.ts src/runtime/__tests__/host-spawn-args.test.ts src/runtime/__tests__/document-rpc.test.ts src/__tests__/tracked-review-route.test.ts src/__tests__/structured-document-rpc.e2e.test.ts src/__tests__/request-timeout-ms.e2e.test.ts src/__tests__/agent-evidence.e2e.test.ts src/__tests__/agent-apply.e2e.test.ts src/__tests__/find-text.e2e.test.ts src/__tests__/custom-actions.e2e.test.ts",
+    "test:cli-host": "bun test src/__tests__/diff-direct-styles.e2e.test.ts src/__tests__/default-cli-optimization.e2e.test.ts src/runtime/__tests__/host-spawn-args.test.ts src/runtime/__tests__/cli-host.test.ts src/__tests__/tracked-review-route.test.ts src/__tests__/cli-document-lifecycle.e2e.test.ts src/__tests__/request-timeout-ms.e2e.test.ts src/__tests__/agent-evidence.e2e.test.ts src/__tests__/agent-apply.e2e.test.ts src/__tests__/find-text.e2e.test.ts src/__tests__/custom-actions.e2e.test.ts",
     "smoke:product-action": "node scripts/product-action-smoke.mjs"
   }
 }