@superdoc/sdk 2.23.0-next.8 → 2.23.0

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) {