@superdoc/sdk 2.23.0-next.1 → 2.23.0-next.11

package/dist/action-primitives/tools/structure-insert.cjs

@@ -3,6 +3,7 @@
 var docIndex = require('../doc-index.cjs');
 var engine = require('../engine.cjs');
 var resolve = require('../resolve.cjs');
+var guards = require('../../guards.cjs');
 
 const STRUCTURE_INSERT_ACTIONS = [
     'insert_toc',
@@ -22,9 +23,6 @@ const DEFAULT_TOC_CONFIG = {
     rightAlignPageNumbers: true,
     tabLeader: 'dot',
 };
-function isObjectRecord(value) {
-    return value != null && typeof value === 'object' && !Array.isArray(value);
-}
 function parseAction(raw) {
     if (typeof raw !== 'string') {
         return undefined;
@@ -166,7 +164,7 @@ function resolvePlacement(context, action) {
             source: 'provided',
         });
     }
-    if (!isObjectRecord(rawPlacement)) {
+    if (!guards.isRecord(rawPlacement)) {
         return engine.workflowStepFailure({
             status: 'failed',
             phase: 'resolve',
@@ -960,7 +958,7 @@ async function executeStep(context, _resolved, plan) {
             sectionId: 'section-break-fallback',
         });
     }
-    const sectionId = isObjectRecord(sectionResult.section) && typeof sectionResult.section.sectionId === 'string'
+    const sectionId = guards.isRecord(sectionResult.section) && typeof sectionResult.section.sectionId === 'string'
         ? sectionResult.section.sectionId
         : undefined;
     const afterInfo = await context.documentHandle.info({}, context.invokeOptions);

package/dist/action-primitives/tools/structure-insert.js

@@ -1,6 +1,7 @@
 import { buildWorkflowDocIndex } from '../doc-index.js';
 import { runWorkflowEngine, workflowStepFailure, workflowStepSuccess, } from '../engine.js';
 import { resolveWorkflowTargetFromUnknown, } from '../resolve.js';
+import { isRecord } from '../../guards.js';
 const STRUCTURE_INSERT_ACTIONS = [
     'insert_toc',
     'insert_section_break',
@@ -19,9 +20,6 @@ const DEFAULT_TOC_CONFIG = {
     rightAlignPageNumbers: true,
     tabLeader: 'dot',
 };
-function isObjectRecord(value) {
-    return value != null && typeof value === 'object' && !Array.isArray(value);
-}
 function parseAction(raw) {
     if (typeof raw !== 'string') {
         return undefined;
@@ -163,7 +161,7 @@ function resolvePlacement(context, action) {
             source: 'provided',
         });
     }
-    if (!isObjectRecord(rawPlacement)) {
+    if (!isRecord(rawPlacement)) {
         return workflowStepFailure({
             status: 'failed',
             phase: 'resolve',
@@ -957,7 +955,7 @@ async function executeStep(context, _resolved, plan) {
             sectionId: 'section-break-fallback',
         });
     }
-    const sectionId = isObjectRecord(sectionResult.section) && typeof sectionResult.section.sectionId === 'string'
+    const sectionId = isRecord(sectionResult.section) && typeof sectionResult.section.sectionId === 'string'
         ? sectionResult.section.sectionId
         : undefined;
     const afterInfo = await context.documentHandle.info({}, context.invokeOptions);

package/dist/action-primitives/tools/text-transform.cjs

@@ -2,13 +2,11 @@
 
 var engine = require('../engine.cjs');
 var resolve = require('../resolve.cjs');
+var guards = require('../../guards.cjs');
 
 const TEXT_TRANSFORM_ACTIONS = ['replace_all', 'delete_all', 'rewrite_block', 'fill_placeholders'];
 const CHANGE_MODES = ['direct', 'tracked'];
 const REWRITE_BLOCK_SUPPORTED_NODE_TYPES = ['paragraph', 'heading', 'listItem'];
-function isObjectRecord(value) {
-    return value != null && typeof value === 'object' && !Array.isArray(value);
-}
 function coerceBoolean(raw, fallback) {
     if (typeof raw === 'boolean') {
         return raw;
@@ -155,7 +153,7 @@ function parseEdits(raw) {
     }
     const edits = [];
     for (const entry of raw) {
-        if (!isObjectRecord(entry)) {
+        if (!guards.isRecord(entry)) {
             return undefined;
         }
         const find = entry.find;
@@ -184,7 +182,7 @@ function parsePlaceholderValues(raw) {
             values.push(entry);
             continue;
         }
-        if (isObjectRecord(entry) && typeof entry.value === 'string' && entry.value.length > 0) {
+        if (guards.isRecord(entry) && typeof entry.value === 'string' && entry.value.length > 0) {
             values.push(entry.value);
             continue;
         }

package/dist/action-primitives/tools/text-transform.js

@@ -1,11 +1,9 @@
 import { runWorkflowEngine, workflowStepFailure, workflowStepSuccess, } from '../engine.js';
 import { resolveWorkflowTargetFromUnknown, } from '../resolve.js';
+import { isRecord } from '../../guards.js';
 const TEXT_TRANSFORM_ACTIONS = ['replace_all', 'delete_all', 'rewrite_block', 'fill_placeholders'];
 const CHANGE_MODES = ['direct', 'tracked'];
 const REWRITE_BLOCK_SUPPORTED_NODE_TYPES = ['paragraph', 'heading', 'listItem'];
-function isObjectRecord(value) {
-    return value != null && typeof value === 'object' && !Array.isArray(value);
-}
 function coerceBoolean(raw, fallback) {
     if (typeof raw === 'boolean') {
         return raw;
@@ -152,7 +150,7 @@ function parseEdits(raw) {
     }
     const edits = [];
     for (const entry of raw) {
-        if (!isObjectRecord(entry)) {
+        if (!isRecord(entry)) {
             return undefined;
         }
         const find = entry.find;
@@ -181,7 +179,7 @@ function parsePlaceholderValues(raw) {
             values.push(entry);
             continue;
         }
-        if (isObjectRecord(entry) && typeof entry.value === 'string' && entry.value.length > 0) {
+        if (isRecord(entry) && typeof entry.value === 'string' && entry.value.length > 0) {
             values.push(entry.value);
             continue;
         }

package/dist/actions/define.cjs

@@ -4,6 +4,7 @@ var errors = require('../runtime/errors.cjs');
 var presets = require('../presets.cjs');
 var actions = require('../agent/actions.cjs');
 var catalog = require('../agent/catalog.cjs');
+var guards = require('../guards.cjs');
 
 /**
  * Customer-extensible **custom actions** for the SuperDoc LLM-tools SDK. The
@@ -71,7 +72,7 @@ function coerceInputSchema(input) {
         // `{ type: 'object', additionalProperties: true }`). The declared type makes
         // `properties` required and every consumer (and the Python mirror) assumes
         // it exists, so normalize a missing/non-object bag to {}.
-        return isRecord(input.properties) ? input : { ...input, properties: {} };
+        return guards.isRecord(input.properties) ? input : { ...input, properties: {} };
     }
     // A bare properties bag — wrap it.
     return { type: 'object', properties: input, additionalProperties: true };
@@ -121,7 +122,7 @@ function defineAction(input) {
             if (!BUILTIN_ACTION_NAMES.has(step.action)) {
                 throw new errors.SuperDocCliError(`defineAction "${input.name}": steps[${index}].action "${step.action}" is not a built-in core action. Steps compose built-in actions only; use the \`run\` tier for anything else.`, { code: 'INVALID_ARGUMENT', details: { name: input.name, index, action: step.action } });
             }
-            if (step.args != null && !isRecord(step.args)) {
+            if (step.args != null && !guards.isRecord(step.args)) {
                 throw new errors.SuperDocCliError(`defineAction "${input.name}": steps[${index}].args must be an object.`, {
                     code: 'INVALID_ARGUMENT',
                     details: { name: input.name, index },
@@ -240,9 +241,6 @@ function assertActionsValid(actions, presetId, standalone = false) {
 // ---------------------------------------------------------------------------
 // runCustomAction — validate, codegen, dispatch via superdoc_execute_code, map receipt
 // ---------------------------------------------------------------------------
-function isRecord(value) {
-    return value != null && typeof value === 'object' && !Array.isArray(value);
-}
 /** Kit-level args every custom action accepts without declaring them. */
 const IMPLICIT_ACTION_ARGS = new Set(['changeMode', 'rationale']);
 function validateAgainstSchema(action, args) {
@@ -254,7 +252,7 @@ function validateAgainstSchema(action, args) {
             details: { action: action.name, missingKeys: missing },
         });
     }
-    const properties = isRecord(action.inputSchema.properties) ? action.inputSchema.properties : {};
+    const properties = guards.isRecord(action.inputSchema.properties) ? action.inputSchema.properties : {};
     if (action.inputSchema.additionalProperties === false) {
         const unknown = Object.keys(args).filter((key) => !(key in properties) && !IMPLICIT_ACTION_ARGS.has(key));
         if (unknown.length > 0) {
@@ -266,7 +264,7 @@ function validateAgainstSchema(action, args) {
     }
     for (const [key, prop] of Object.entries(properties)) {
         const value = args[key];
-        if (value !== undefined && isRecord(prop) && Array.isArray(prop.enum) && !prop.enum.includes(value)) {
+        if (value !== undefined && guards.isRecord(prop) && Array.isArray(prop.enum) && !prop.enum.includes(value)) {
             throw new errors.SuperDocCliError(`Invalid value for ${action.name}.${key}: ${JSON.stringify(value)} (allowed: ${prop.enum.map((entry) => JSON.stringify(entry)).join(', ')})`, { code: 'INVALID_ARGUMENT', details: { action: action.name, key, allowed: prop.enum } });
         }
     }
@@ -275,7 +273,7 @@ function validateAgainstSchema(action, args) {
 function applyInputDefaults(action, args) {
     const out = { ...args };
     for (const [key, prop] of Object.entries(action.inputSchema.properties ?? {})) {
-        if (out[key] === undefined && isRecord(prop) && 'default' in prop)
+        if (out[key] === undefined && guards.isRecord(prop) && 'default' in prop)
             out[key] = prop.default;
     }
     return out;
@@ -309,7 +307,7 @@ function substituteTemplates(node, vars) {
         // would crash the transport).
         return node.map((item) => substituteTemplates(item, vars)).filter((item) => item !== undefined);
     }
-    if (isRecord(node)) {
+    if (guards.isRecord(node)) {
         const out = {};
         for (const [key, value] of Object.entries(node)) {
             const substituted = substituteTemplates(value, vars);
@@ -341,7 +339,7 @@ async function runStepsAction(base, action, documentHandle, args, invokeOptions)
         let receipt;
         try {
             const dispatched = await base.dispatch(documentHandle, 'superdoc_perform_action', { action: step.action, ...stepArgs }, stepOptions);
-            receipt = isRecord(dispatched) ? dispatched : { status: 'ok', result: dispatched };
+            receipt = guards.isRecord(dispatched) ? dispatched : { status: 'ok', result: dispatched };
         }
         catch (error) {
             // Validation errors THROW from dispatch; runtime failures come back as
@@ -458,13 +456,13 @@ function renormalizeAnthropicCacheMarker(tools, provider, cacheRequested) {
     if (provider !== 'anthropic' || !cacheRequested || tools.length === 0)
         return tools;
     const stripped = tools.map((tool) => {
-        if (!isRecord(tool) || !('cache_control' in tool))
+        if (!guards.isRecord(tool) || !('cache_control' in tool))
             return tool;
         const { cache_control: _drop, ...rest } = tool;
         return rest;
     });
     const last = stripped[stripped.length - 1];
-    stripped[stripped.length - 1] = isRecord(last) ? { ...last, cache_control: { type: 'ephemeral' } } : last;
+    stripped[stripped.length - 1] = guards.isRecord(last) ? { ...last, cache_control: { type: 'ephemeral' } } : last;
     return stripped;
 }
 function customActionsDescription(actions) {
@@ -535,16 +533,16 @@ function mergeIntoAgentAction(tools, actions) {
         // Provider dialects: openai nests under `function` (`parameters`);
         // anthropic is flat with `input_schema`; the core agent dialect for
         // vercel is flat with `inputSchema`; generic is flat with `parameters`.
-        const fn = isRecord(t.function) ? t.function : null;
+        const fn = guards.isRecord(t.function) ? t.function : null;
         const schemaContainer = fn ?? t;
         const schemaKey = 'input_schema' in schemaContainer
             ? 'input_schema'
             : 'inputSchema' in schemaContainer
                 ? 'inputSchema'
                 : 'parameters';
-        const schema = isRecord(schemaContainer[schemaKey]) ? schemaContainer[schemaKey] : {};
-        const properties = isRecord(schema.properties) ? { ...schema.properties } : {};
-        const actionProp = isRecord(properties.action) ? { ...properties.action } : {};
+        const schema = guards.isRecord(schemaContainer[schemaKey]) ? schemaContainer[schemaKey] : {};
+        const properties = guards.isRecord(schema.properties) ? { ...schema.properties } : {};
+        const actionProp = guards.isRecord(properties.action) ? { ...properties.action } : {};
         const enumValues = Array.isArray(actionProp.enum) ? [...actionProp.enum] : [];
         for (const action of actions) {
             if (!enumValues.includes(action.name))
@@ -748,7 +746,7 @@ function extendPreset(baseId, options) {
         // must be refused before it runs (the base can only refuse built-ins).
         const exclusionOptions = invokeOptions;
         const excluded = new Set(exclusionOptions?.excludeActions ?? []);
-        if (toolName === 'superdoc_perform_action' && isRecord(args) && typeof args.action === 'string') {
+        if (toolName === 'superdoc_perform_action' && guards.isRecord(args) && typeof args.action === 'string') {
             // Advertised surface == dispatchable surface: in standalone mode custom
             // actions are advertised as their own tools, so the (unadvertised)
             // perform_action route must not execute them — it falls through to the

package/dist/actions/define.js

@@ -32,6 +32,7 @@ import { SuperDocCliError } from '../runtime/errors.js';
 import { getPreset, } from '../presets.js';
 import { ACTION_NAMES_LIST } from '../agent/actions.js';
 import { AGENT_TOOL_NAMES, buildPerformActionDefinition } from '../agent/catalog.js';
+import { isRecord } from '../guards.js';
 /** Which execution tier a spec uses. */
 export function executionKindOf(spec) {
     return Array.isArray(spec.steps) ? 'steps' : 'run';
@@ -237,9 +238,6 @@ function assertActionsValid(actions, presetId, standalone = false) {
 // ---------------------------------------------------------------------------
 // runCustomAction — validate, codegen, dispatch via superdoc_execute_code, map receipt
 // ---------------------------------------------------------------------------
-function isRecord(value) {
-    return value != null && typeof value === 'object' && !Array.isArray(value);
-}
 /** Kit-level args every custom action accepts without declaring them. */
 const IMPLICIT_ACTION_ARGS = new Set(['changeMode', 'rationale']);
 function validateAgainstSchema(action, args) {

package/dist/agent/actions.cjs

@@ -9,6 +9,7 @@ var listTransform = require('../action-primitives/tools/list-transform.cjs');
 var structureInsert = require('../action-primitives/tools/structure-insert.cjs');
 var textTransform = require('../action-primitives/tools/text-transform.cjs');
 var docSnapshot = require('./doc-snapshot.cjs');
+var guards = require('../guards.cjs');
 
 const ACTION_DEFINITIONS = actionDescriptors;
 function projectActionDefinitions(project) {
@@ -72,9 +73,6 @@ function getActionDispositions() {
 function isActionName(value) {
     return typeof value === 'string' && ACTION_NAMES.includes(value);
 }
-function isRecord(value) {
-    return value != null && typeof value === 'object' && !Array.isArray(value);
-}
 /** The message to put in a receipt when something best-effort did not happen. */
 function reasonOf(err) {
     return err instanceof Error ? err.message : String(err);
@@ -100,7 +98,7 @@ function isNoOp(err) {
     return err?.code === 'NO_OP';
 }
 function asRecord(value) {
-    return isRecord(value) ? value : null;
+    return guards.isRecord(value) ? value : null;
 }
 function asString(value, fallback) {
     return typeof value === 'string' ? value : fallback;
@@ -657,7 +655,7 @@ async function previewMutations(doc, steps, changeMode, expectedRevision) {
         });
     }
     const result = await fn({ atomic: true, changeMode: changeMode ?? 'direct', expectedRevision, steps });
-    return isRecord(result) ? result : {};
+    return guards.isRecord(result) ? result : {};
 }
 async function executeCreateTable(doc, args, placement) {
     const fn = maybeMethod(doc, ['create', 'table']);
@@ -1052,7 +1050,7 @@ async function runReplaceTextUnchecked(doc, args) {
                     const preview = await previewMutations(doc, candidates.map((candidate) => candidate.step), args.changeMode, pre.revision);
                     if (preview.valid === true)
                         break;
-                    const failures = Array.isArray(preview.failures) ? preview.failures.filter(isRecord) : [];
+                    const failures = Array.isArray(preview.failures) ? preview.failures.filter(guards.isRecord) : [];
                     const absent = failures.find((failure) => failure.code === 'MATCH_NOT_FOUND' && typeof failure.stepId === 'string');
                     if (!absent) {
                         throw new Error(typeof failures[0]?.message === 'string' ? failures[0].message : 'replacement plan could not be prepared');
@@ -2713,7 +2711,7 @@ async function listAllTrackedChanges(listFn) {
         const page = asRecord(await listFn({ offset, limit: PAGE, in: 'all' }));
         const items = Array.isArray(page?.items) ? page.items : [];
         for (const item of items) {
-            if (isRecord(item))
+            if (guards.isRecord(item))
                 out.push(item);
         }
         const total = asNumber(page?.total, out.length) ?? out.length;
@@ -4290,12 +4288,12 @@ function findTextTarget(snapshot, nodeId) {
     return null;
 }
 function compactOpResult(result) {
-    if (!isRecord(result))
+    if (!guards.isRecord(result))
         return result;
     const compact = {};
     if (typeof result.success === 'boolean')
         compact.success = result.success;
-    if (isRecord(result.revision))
+    if (guards.isRecord(result.revision))
         compact.revision = result.revision;
     if (Array.isArray(result.steps))
         compact.stepCount = result.steps.length;
@@ -4311,7 +4309,7 @@ function trackedChangeRefIds(result) {
     }));
 }
 function parseScopedReplaceArgs(args, edits, changeMode, expectedRevision) {
-    if (!isRecord(args.selector))
+    if (!guards.isRecord(args.selector))
         return null;
     return {
         edits,
@@ -4341,9 +4339,9 @@ async function fieldResultRanges(doc, nodeId, blockText) {
     const limit = 500;
     for (let offset = 0; offset < 100_000; offset += limit) {
         const page = await fn({ limit, offset });
-        const items = isRecord(page) && Array.isArray(page.items) ? page.items.filter(isRecord) : [];
+        const items = guards.isRecord(page) && Array.isArray(page.items) ? page.items.filter(guards.isRecord) : [];
         for (const item of items) {
-            const address = isRecord(item.address) ? item.address : null;
+            const address = guards.isRecord(item.address) ? item.address : null;
             const inBody = typeof address?.storyId !== 'string' || address.storyId.startsWith('main:');
             if (address?.blockId !== nodeId || !inBody)
                 continue;
@@ -4352,7 +4350,7 @@ async function fieldResultRanges(doc, nodeId, blockText) {
             }
             results.push(item.resolvedText);
         }
-        const total = isRecord(page) && typeof page.total === 'number' ? page.total : null;
+        const total = guards.isRecord(page) && typeof page.total === 'number' ? page.total : null;
         if (items.length < limit || (total != null && offset + limit >= total))
             break;
     }
@@ -4493,11 +4491,11 @@ async function runScopedReplaceUnchecked(doc, args) {
             // that each one still covers the text matched in the snapshot, so a
             // projection mismatch never rewrites other text.
             const preview = await previewMutations(doc, steps, args.changeMode, pre.revision);
-            const previewSteps = Array.isArray(preview.steps) ? preview.steps.filter(isRecord) : [];
+            const previewSteps = Array.isArray(preview.steps) ? preview.steps.filter(guards.isRecord) : [];
             const aligned = preview.valid === true &&
                 steps.every((step, index) => {
                     const resolutions = previewSteps.find((candidate) => candidate.stepId === step.id)?.resolutions;
-                    const resolved = Array.isArray(resolutions) && isRecord(resolutions[0]) ? resolutions[0].text : undefined;
+                    const resolved = Array.isArray(resolutions) && guards.isRecord(resolutions[0]) ? resolutions[0].text : undefined;
                     const span = targetedSpans[index];
                     return resolved === block.text.slice(span.start, span.end);
                 });
@@ -4530,7 +4528,7 @@ async function runScopedReplaceUnchecked(doc, args) {
     // atomic history step. Only do so while the document is still at the
     // revision this plan produced, so the undo cannot reach any other change.
     let rolledBack = false;
-    const appliedRevision = isRecord(result) && isRecord(result.revision) ? result.revision.after : undefined;
+    const appliedRevision = guards.isRecord(result) && guards.isRecord(result.revision) ? result.revision.after : undefined;
     if (wroteExactTargets &&
         postBlock != null &&
         postBlock.text !== expected &&
@@ -4645,13 +4643,13 @@ function markRunPropsFromMarks(marks) {
  * paragraphIndentOf. Returns null when the paragraph mark carries nothing.
  */
 function paragraphMarkRunPropsOf(payload) {
-    const node = isRecord(payload) ? payload.node : null;
-    if (!isRecord(node))
+    const node = guards.isRecord(payload) ? payload.node : null;
+    if (!guards.isRecord(node))
         return null;
-    const candidates = [isRecord(node.paragraph) ? node.paragraph.props : null, node.props];
+    const candidates = [guards.isRecord(node.paragraph) ? node.paragraph.props : null, node.props];
     for (const props of candidates) {
-        const mark = isRecord(props) ? props.markRunProps : null;
-        if (isRecord(mark) && Object.keys(mark).length > 0)
+        const mark = guards.isRecord(props) ? props.markRunProps : null;
+        if (guards.isRecord(mark) && Object.keys(mark).length > 0)
             return mark;
     }
     return null;
@@ -4896,13 +4894,13 @@ async function listItemRunPattern(doc, text, blockId) {
  * indent copied" rather than a thrown read.
  */
 function paragraphIndentOf(payload) {
-    const node = isRecord(payload) ? payload.node : null;
-    if (!isRecord(node))
+    const node = guards.isRecord(payload) ? payload.node : null;
+    if (!guards.isRecord(node))
         return null;
-    const candidates = [isRecord(node.paragraph) ? node.paragraph.props : null, node.props];
+    const candidates = [guards.isRecord(node.paragraph) ? node.paragraph.props : null, node.props];
     for (const props of candidates) {
-        const indent = isRecord(props) ? props.indent : null;
-        if (!isRecord(indent))
+        const indent = guards.isRecord(props) ? props.indent : null;
+        if (!guards.isRecord(indent))
             continue;
         const twips = {};
         for (const key of ['left', 'right', 'firstLine', 'hanging']) {
@@ -4979,7 +4977,7 @@ function marksToInline(marks) {
 }
 /** Parse a raw agent mark bag, keeping only recognized keys with valid types. */
 function normalizeMarks(raw) {
-    if (!isRecord(raw))
+    if (!guards.isRecord(raw))
         return undefined;
     const m = {};
     if (typeof raw.bold === 'boolean')
@@ -5009,7 +5007,7 @@ function normalizeMarks(raw) {
 function normalizeItemSpec(raw) {
     if (typeof raw === 'string')
         return { text: raw, level: 0 };
-    if (!isRecord(raw))
+    if (!guards.isRecord(raw))
         return null;
     const spec = {};
     const lvl = asNumber(raw.level);
@@ -5023,7 +5021,7 @@ function normalizeItemSpec(raw) {
             if (typeof r === 'string') {
                 runs.push({ text: r });
             }
-            else if (isRecord(r) && typeof r.text === 'string') {
+            else if (guards.isRecord(r) && typeof r.text === 'string') {
                 const rm = normalizeMarks(r.marks);
                 runs.push(rm ? { text: r.text, marks: rm } : { text: r.text });
             }
@@ -5642,9 +5640,9 @@ async function appendListAtPlacement(doc, args) {
     const items = Array.isArray(args.items)
         ? args.items.filter((t) => typeof t === 'string' && t.length > 0)
         : [];
-    const placement = isRecord(args.placement) ? args.placement : null;
+    const placement = guards.isRecord(args.placement) ? args.placement : null;
     const at = placement && typeof placement.at === 'string' ? placement.at : null;
-    const selector = placement && isRecord(placement.selector) ? placement.selector : null;
+    const selector = placement && guards.isRecord(placement.selector) ? placement.selector : null;
     if (items.length === 0 || !placement || (at !== 'after' && at !== 'before') || !selector)
         return null;
     const pre = await docSnapshot.buildMutationSnapshot(doc, { includeDomains: ['blocks'] });
@@ -6042,15 +6040,15 @@ async function matchInsertedBlockFormatting(doc, preBlocks, receipt, args, avail
             return receipt;
         // The placement anchor, when the action targeted one, is the user's own
         // statement of "blend in with THIS" — prefer it over type-matched siblings.
-        const placement = isRecord(args?.placement) ? args.placement : null;
-        const anchorSelector = placement && isRecord(placement.selector) ? placement.selector : null;
+        const placement = guards.isRecord(args?.placement) ? args.placement : null;
+        const anchorSelector = placement && guards.isRecord(placement.selector) ? placement.selector : null;
         const anchorId = anchorSelector && typeof anchorSelector.nodeId === 'string' ? anchorSelector.nodeId : null;
         const anchorRow = anchorId ? (postBlocks.find((b) => b.nodeId === anchorId) ?? null) : null;
         // When the caller styled any entry explicitly (runs/marks), it took
         // ownership of intra-paragraph formatting — the automatic lead-marker
         // pattern pass must not fight it.
         const rawTexts = Array.isArray(args?.texts) ? args.texts : [];
-        const hasExplicitStyling = rawTexts.some((entry) => isRecord(entry) && (Array.isArray(entry.runs) || entry.marks != null));
+        const hasExplicitStyling = rawTexts.some((entry) => guards.isRecord(entry) && (Array.isArray(entry.runs) || entry.marks != null));
         const insertedTexts = rawTexts.map((entry) => {
             if (typeof entry === 'string')
                 return entry;
@@ -6075,7 +6073,7 @@ async function matchInsertedBlockFormatting(doc, preBlocks, receipt, args, avail
             // the previous NAME line, not like the "Name:" line directly above it.
             // Only tried when matching against the neighbour found nothing, so this
             // cannot change a case that already had an answer.
-            const applied = isRecord(result?.applied) ? result.applied : null;
+            const applied = guards.isRecord(result?.applied) ? result.applied : null;
             if (createdRows.length > 1 && (!applied || Object.keys(applied).length === 0)) {
                 const parallel = postBlocks[createdIndex - createdRows.length];
                 if (parallel && preIds.has(parallel.nodeId) && !parallel.isEmpty) {
@@ -6291,7 +6289,7 @@ async function runAttachNumbering(doc, args) {
     };
 }
 async function dispatchSuperdocPerformAction(doc, args) {
-    if (!isRecord(args)) {
+    if (!guards.isRecord(args)) {
         throw new errors.SuperDocCliError('superdoc_perform_action arguments must be an object', {
             code: 'INVALID_ARGUMENT',
         });
@@ -6365,7 +6363,7 @@ async function dispatchSuperdocPerformAction(doc, args) {
             if (expectedRevision !== undefined && (typeof expectedRevision !== 'string' || expectedRevision.length === 0)) {
                 throw new errors.SuperDocCliError('replace_text: expectedRevision must be a non-empty string from this live document handle', { code: 'INVALID_ARGUMENT' });
             }
-            if (edits.some((edit) => edit.occurrence != null) && !isRecord(args.selector)) {
+            if (edits.some((edit) => edit.occurrence != null) && !guards.isRecord(args.selector)) {
                 throw new errors.SuperDocCliError('replace_text: explicit occurrence requires a selector resolving to one block', {
                     code: 'INVALID_ARGUMENT',
                 });
@@ -6995,13 +6993,13 @@ function parseExactTrackedChangeIdList(value) {
 }
 async function superdocPerformAction(doc, args) {
     try {
-        const changeMode = isRecord(args) ? parseChangeMode(args.changeMode) : undefined;
+        const changeMode = guards.isRecord(args) ? parseChangeMode(args.changeMode) : undefined;
         return await dispatchSuperdocPerformAction(changeMode ? actionChangeMode.bindActionChangeMode(doc, changeMode) : doc, args);
     }
     catch (error) {
         if (!(error instanceof docSnapshot.MutationSnapshotError))
             throw error;
-        const action = isRecord(args) && isActionName(args.action) ? args.action : 'superdoc_perform_action';
+        const action = guards.isRecord(args) && isActionName(args.action) ? args.action : 'superdoc_perform_action';
         return {
             status: 'failed',
             intent: action,
@@ -7062,7 +7060,7 @@ function parseEdits(value) {
         return undefined;
     const result = [];
     for (const entry of value) {
-        if (!isRecord(entry))
+        if (!guards.isRecord(entry))
             return undefined;
         const find = asString(entry.find);
         const replace = asString(entry.replace) ?? '';
@@ -7082,7 +7080,7 @@ function parseEdits(value) {
 function parseCellCandidate(cell) {
     if (typeof cell === 'string')
         return cell;
-    if (isRecord(cell)) {
+    if (guards.isRecord(cell)) {
         const spec = normalizeItemSpec(cell);
         if (spec)
             return { text: spec.text, runs: spec.runs, marks: spec.marks };
@@ -7110,7 +7108,7 @@ function parsePlaceholderFields(value) {
         return undefined;
     const result = [];
     for (const entry of value) {
-        if (!isRecord(entry) || typeof entry.value !== 'string')
+        if (!guards.isRecord(entry) || typeof entry.value !== 'string')
             return undefined;
         const label = asString(entry.label);
         result.push(label ? { label, value: entry.value } : { value: entry.value });
@@ -7118,7 +7116,7 @@ function parsePlaceholderFields(value) {
     return result;
 }
 function parsePlacement(value) {
-    if (!isRecord(value))
+    if (!guards.isRecord(value))
         return undefined;
     const at = asString(value.at);
     if (at === 'document_end' || at === 'document_start') {
@@ -7133,7 +7131,7 @@ function parsePlacement(value) {
     return undefined;
 }
 function parseSelector(value) {
-    if (!isRecord(value))
+    if (!guards.isRecord(value))
         return undefined;
     const kind = asString(value.kind);
     if (kind === 'nodeId') {

package/dist/agent/actions.js

@@ -7,6 +7,7 @@ import { runSuperdocListTransformWorkflow } from '../action-primitives/tools/lis
 import { runSuperdocStructureInsertWorkflow } from '../action-primitives/tools/structure-insert.js';
 import { runSuperdocTextTransformWorkflow } from '../action-primitives/tools/text-transform.js';
 import { buildDocumentSnapshot, buildMutationSnapshot, matchRunsForBlock, MutationSnapshotError, resolveSnapshotSelector, } from './doc-snapshot.js';
+import { isRecord } from '../guards.js';
 export const ACTION_DEFINITIONS = actionDescriptors;
 function projectActionDefinitions(project) {
     return Object.fromEntries(Object.entries(ACTION_DEFINITIONS).map(([name, definition]) => [name, project(definition)]));
@@ -69,9 +70,6 @@ export function getActionDispositions() {
 export function isActionName(value) {
     return typeof value === 'string' && ACTION_NAMES.includes(value);
 }
-function isRecord(value) {
-    return value != null && typeof value === 'object' && !Array.isArray(value);
-}
 /** The message to put in a receipt when something best-effort did not happen. */
 function reasonOf(err) {
     return err instanceof Error ? err.message : String(err);

package/dist/agent/operation-catalog.js

@@ -26,10 +26,6 @@ const BENCHMARK_ONLY_HINTS = [
 function tokensFromOperationId(operationId) {
     return operationId.split('.').slice(1);
 }
-function lastToken(operationId) {
-    const tokens = tokensFromOperationId(operationId);
-    return (tokens[tokens.length - 1] ?? '').toLowerCase();
-}
 function deriveDomain(operationId) {
     const tokens = tokensFromOperationId(operationId);
     const first = (tokens[0] ?? '').toLowerCase();