@superdoc/sdk 2.26.0-next.3 → 2.26.0-next.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -92,7 +92,7 @@ const document = await client.open(
92
92
 
93
93
  The credential applies only to that open request. It is not part of the
94
94
  collaboration profile or command-line arguments. Per-open token authentication
95
- is not supported for Liveblocks or the standalone document host.
95
+ is not supported for Liveblocks.
96
96
 
97
97
  See the [Node.js SDK guide](https://docs.superdoc.dev/agents/automation/node-sdk) for a complete workflow.
98
98
 
@@ -183,7 +183,6 @@ const session = await openVersionedDocumentReviewSession({ store, documentId, ac
183
183
  const client = createSuperDocClient({
184
184
  user: { name: actor },
185
185
  requestTimeoutMs: 120_000,
186
- env: { SUPERDOC_SDK_DOCUMENT_HOST_BIN: 'embedded' },
187
186
  });
188
187
  try {
189
188
  const { diff, comparisonError, result } = await runTrackedComparisonReview({
@@ -220,7 +219,7 @@ authorization, durable storage, reviewer presentation, and decisions.
220
219
  ## Agent execution evidence
221
220
 
222
221
  The core preset's `agent_apply`, `agent_verify`, and supported named actions
223
- collect the facts their targets and checks need. Supported document-host sessions
222
+ collect the facts their targets and checks need. CLI-backed sessions
224
223
  can read body block identities and text, table shape, exact requested block
225
224
  counts, and document revisions without collecting complete snapshots. The named
226
225
  paths cover table creation and cell styling, body paragraph formatting and
@@ -229,9 +228,9 @@ rewriting, and paragraph insertion around a selected anchor.
229
228
  The shared execution paths on supported hosts guard edits with document revisions.
230
229
  An intervening edit can stop a later step; a failed action may therefore include operations that already committed.
231
230
 
232
- This changes default receipts for eligible plans: `preSnapshot.counts` and
233
- `postSnapshot.counts` are absent, not zero. Callers that previously consumed these
234
- counts should request `evidence: 'full'`:
231
+ CLI-backed sessions preserve `preSnapshot.counts` and `postSnapshot.counts`
232
+ using compact execution summaries. Request `evidence: 'full'` when a workflow
233
+ needs complete snapshot evidence:
235
234
 
236
235
  ```js
237
236
  import { dispatchSuperDocTool } from '@superdoc/sdk';
@@ -249,14 +248,13 @@ const receipt = await dispatchSuperDocTool(document, 'agent_apply', {
249
248
  ```
250
249
 
251
250
  `evidence: 'required'` is the default. Requested block-count checks remain exact
252
- without adding unrequested receipt summaries. `evidence: 'full'` is also available
251
+ and CLI receipts retain their count summaries. `evidence: 'full'` is also available
253
252
  on `agent_verify` and the named `create_table`, `format_paragraph`, `rewrite_block`,
254
253
  and `insert_paragraphs` actions.
255
254
 
256
255
  Unsupported selectors and checks, inspection dependencies, multiple-operation
257
- plans, atomic plans, and save verification retain complete evidence. Older hosts
258
- with compact revision support retain the single-paragraph, revision-only path;
259
- other unsupported hosts and plain bound API handles use complete snapshots.
256
+ plans, atomic plans, and save verification retain complete evidence. Older CLI hosts
257
+ without typed execution facts and plain bound API handles use complete snapshots.
260
258
 
261
259
  A failed receipt can disclose a committed mutation when post-edit verification
262
260
  fails. Inspect `executedOperations` and the reported error before retrying; do not