@superdoc-dev/sdk 1.19.1 → 1.20.0

package/dist/generated/intent-dispatch.generated.cjs

@@ -103,7 +103,6 @@ function dispatchIntentTool(toolName, args, execute) {
                 case 'set_layout': return execute('doc.tables.setLayout', rest);
                 case 'insert_row': return execute('doc.tables.insertRow', rest);
                 case 'delete_row': return execute('doc.tables.deleteRow', rest);
-                case 'move_row': return execute('doc.tables.moveRow', rest);
                 case 'set_row': return execute('doc.tables.setRowHeight', rest);
                 case 'set_row_options': return execute('doc.tables.setRowOptions', rest);
                 case 'insert_column': return execute('doc.tables.insertColumn', rest);

package/dist/generated/intent-dispatch.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intent-dispatch.generated.d.ts","sourceRoot":"","sources":["../../src/generated/intent-dispatch.generated.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GACxE,OAAO,CA0HT"}
+{"version":3,"file":"intent-dispatch.generated.d.ts","sourceRoot":"","sources":["../../src/generated/intent-dispatch.generated.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GACxE,OAAO,CAyHT"}

package/dist/generated/intent-dispatch.generated.js

@@ -101,7 +101,6 @@ export function dispatchIntentTool(toolName, args, execute) {
                 case 'set_layout': return execute('doc.tables.setLayout', rest);
                 case 'insert_row': return execute('doc.tables.insertRow', rest);
                 case 'delete_row': return execute('doc.tables.deleteRow', rest);
-                case 'move_row': return execute('doc.tables.moveRow', rest);
                 case 'set_row': return execute('doc.tables.setRowHeight', rest);
                 case 'set_row_options': return execute('doc.tables.setRowOptions', rest);
                 case 'insert_column': return execute('doc.tables.insertColumn', rest);

package/dist/index.cjs

@@ -80,13 +80,6 @@ class SuperDocDocumentCore {
     markClosed() {
         this.boundRuntime.markClosed();
     }
-    async formatRange(params, options = {}) {
-        const { properties, ...rest } = params;
-        return this.boundRuntime.invoke(contract.CONTRACT.operations['doc.format.apply'], {
-            ...rest,
-            inline: properties,
-        }, options);
-    }
 }
 function attachBoundDocApi(target, api) {
     const { save: _save, close: _close, ...boundMethods } = api;
@@ -166,6 +159,7 @@ exports.getSkill = skills.getSkill;
 exports.installSkill = skills.installSkill;
 exports.listSkills = skills.listSkills;
 exports.chooseTools = tools.chooseTools;
+exports.createAgentToolkit = tools.createAgentToolkit;
 exports.dispatchSuperDocTool = tools.dispatchSuperDocTool;
 exports.getMcpPrompt = tools.getMcpPrompt;
 exports.getSystemPrompt = tools.getSystemPrompt;
@@ -176,6 +170,8 @@ exports.dispatchIntentTool = intentDispatch_generated.dispatchIntentTool;
 exports.DEFAULT_PRESET = presets.DEFAULT_PRESET;
 exports.getPreset = presets.getPreset;
 exports.listPresets = presets.listPresets;
+exports.registerPreset = presets.registerPreset;
+exports.unregisterPreset = presets.unregisterPreset;
 exports.SuperDocClient = SuperDocClient;
 exports.SuperDocDocument = SuperDocDocument;
 exports.createSuperDocClient = createSuperDocClient;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { type BoundDocApi, type DocCloseBoundParams, type DocCloseResult, type DocFormatApplyBoundParams, type DocFormatApplyResult, type DocOpenParams as GeneratedDocOpenParams, type DocOpenResult, type DocSaveBoundParams, type DocSaveResult } from './generated/client.js';
+import { type BoundDocApi, type DocCloseBoundParams, type DocCloseResult, type DocOpenParams as GeneratedDocOpenParams, type DocOpenResult, type DocSaveBoundParams, type DocSaveResult } from './generated/client.js';
 import { SuperDocRuntime, type SuperDocClientOptions, type InvokeOptions, type OperationSpec, type RuntimeInvoker } from './runtime/process.js';
 /**
  * Wraps a raw runtime and injects a fixed sessionId into every invoke call.
@@ -14,9 +14,6 @@ declare class BoundRuntime implements RuntimeInvoker {
     invoke<TData = unknown>(operation: OperationSpec, params?: Record<string, unknown>, options?: InvokeOptions): Promise<TData>;
     markClosed(): void;
 }
-export interface DocFormatRangeBoundParams extends Omit<DocFormatApplyBoundParams, 'inline'> {
-    properties: NonNullable<DocFormatApplyBoundParams['inline']>;
-}
 /**
  * Bound document handle. All document operations are available as typed methods.
  * The handle injects its session id automatically — callers never pass
@@ -36,7 +33,6 @@ declare class SuperDocDocumentCore {
     close(params?: DocCloseBoundParams, options?: InvokeOptions): Promise<DocCloseResult>;
     /** @internal */
     markClosed(): void;
-    formatRange(params: DocFormatRangeBoundParams, options?: InvokeOptions): Promise<DocFormatApplyResult>;
 }
 type SuperDocDocumentInstance = SuperDocDocumentCore & BoundDocApi;
 export declare const SuperDocDocument: new (boundRuntime: BoundRuntime, sessionId: string, openResult: DocOpenResult, client: SuperDocClient) => SuperDocDocumentInstance;
@@ -81,9 +77,15 @@ export declare class SuperDocClient {
 }
 export declare function createSuperDocClient(options?: SuperDocClientOptions): SuperDocClient;
 export { getSkill, installSkill, listSkills } from './skills.js';
-export { chooseTools, dispatchSuperDocTool, getMcpPrompt, getSystemPrompt, getSystemPromptForProvider, getToolCatalog, listTools, DEFAULT_PRESET, getPreset, listPresets, } from './tools.js';
+export { chooseTools, dispatchSuperDocTool, getMcpPrompt, getSystemPrompt, getSystemPromptForProvider, getToolCatalog, listTools, DEFAULT_PRESET, getPreset, listPresets, registerPreset, unregisterPreset, } from './tools.js';
 export type { AnthropicSystemPrompt, CacheStrategy, SystemPromptForProviderResult, ToolCatalog, ToolCatalogEntry, ToolCatalogOperation, ToolChooserInput, ToolProvider, } from './tools.js';
 export { dispatchIntentTool } from './generated/intent-dispatch.generated.js';
+export type { BoundDocApi } from './generated/client.js';
+export type { ActionName } from './agent/actions.js';
+export type { AgentReceipt } from './agent/runtime.js';
+export type { GetSystemPromptOptions, GetToolsOptions, GetToolsResult, PresetDescriptor } from './presets.js';
+export { createAgentToolkit } from './tools.js';
+export type { AgentToolkit, CreateAgentToolkitInput } from './tools.js';
 export { SuperDocCliError } from './runtime/errors.js';
 export type { InvokeOptions, OperationSpec, OperationParamSpec, RuntimeInvoker, SuperDocClientOptions, } from './runtime/process.js';
 export type { DocOpenResult } from './generated/client.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -73,13 +73,6 @@ class SuperDocDocumentCore {
     markClosed() {
         this.boundRuntime.markClosed();
     }
-    async formatRange(params, options = {}) {
-        const { properties, ...rest } = params;
-        return this.boundRuntime.invoke(CONTRACT.operations['doc.format.apply'], {
-            ...rest,
-            inline: properties,
-        }, options);
-    }
 }
 function attachBoundDocApi(target, api) {
     const { save: _save, close: _close, ...boundMethods } = api;
@@ -154,6 +147,7 @@ export function createSuperDocClient(options = {}) {
     return new SuperDocClient(options);
 }
 export { getSkill, installSkill, listSkills } from './skills.js';
-export { chooseTools, dispatchSuperDocTool, getMcpPrompt, getSystemPrompt, getSystemPromptForProvider, getToolCatalog, listTools, DEFAULT_PRESET, getPreset, listPresets, } from './tools.js';
+export { chooseTools, dispatchSuperDocTool, getMcpPrompt, getSystemPrompt, getSystemPromptForProvider, getToolCatalog, listTools, DEFAULT_PRESET, getPreset, listPresets, registerPreset, unregisterPreset, } from './tools.js';
 export { dispatchIntentTool } from './generated/intent-dispatch.generated.js';
+export { createAgentToolkit } from './tools.js';
 export { SuperDocCliError } from './runtime/errors.js';

package/dist/presets/core.cjs

@@ -0,0 +1,454 @@
+'use strict';
+
+var promises = require('node:fs/promises');
+var path = require('node:path');
+var node_url = require('node:url');
+var errors = require('../runtime/errors.cjs');
+var catalog = require('../agent/catalog.cjs');
+var runtime = require('../agent/runtime.cjs');
+var actions = require('../agent/actions.cjs');
+var embeddedPrompts_generated = require('../embedded-prompts.generated.cjs');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+/**
+ * `core` preset — actions-only LLM-facing surface.
+ *
+ * Two advertised tools: superdoc_inspect (read-only deterministic snapshots)
+ * and superdoc_perform_action (named, statically validated, deterministic edit
+ * verbs — the action registry in agent/actions.ts).
+ *
+ * superdoc_execute_code (model-authored JS against a synchronous in-host doc)
+ * is WIP: dispatchable for SDK callers, NOT advertised and NOT in the served
+ * system prompt until it ships behind a safety flag. The agent_apply /
+ * agent_verify / agent_operation tools are likewise dispatchable but never
+ * advertised.
+ *
+ * @internal
+ */
+// Prompts ship as <dist>/prompts/*.md. Resolve relative to the compiled
+// module, but the module's depth differs by build: in the SDK package this
+// file is dist/presets/core.js (so prompts are at ../prompts), while the
+// bundled CLI inlines it into dist/index.js (so prompts are at ./prompts).
+// Try both so getSystemPrompt works through the SDK AND the CLI host (the
+// path the Python SDK proxies through).
+const MODULE_DIR = path.dirname(node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('presets/core.cjs', document.baseURI).href))));
+const PROMPT_DIR_CANDIDATES = [path.resolve(MODULE_DIR, '..', 'prompts'), path.resolve(MODULE_DIR, 'prompts')];
+let _actionsOnlyPromptCache = null;
+let _mcpPromptCache = null;
+/** Exported for unit tests; production callers use the default candidates. */
+async function readPromptFile(fileName, label, candidateDirs = PROMPT_DIR_CANDIDATES) {
+    const tried = [];
+    let lastIoError;
+    for (const dir of candidateDirs) {
+        const promptPath = path.join(dir, fileName);
+        tried.push(promptPath);
+        try {
+            return await promises.readFile(promptPath, 'utf8');
+        }
+        catch (err) {
+            const ioError = err;
+            if (ioError?.code !== 'ENOENT') {
+                // Permission/IO failures are not "asset missing" — remember the real
+                // cause, but still try the other layout candidate.
+                lastIoError = ioError;
+            }
+        }
+    }
+    // Filesystem candidates exhausted. Native binaries (bun --compile) resolve
+    // MODULE_DIR inside bun's virtual filesystem where the .md assets don't
+    // exist — fall back to the compiled-in copies (identical content by
+    // construction; a drift test enforces it).
+    const embedded = embeddedPrompts_generated.EMBEDDED_PROMPTS[fileName];
+    if (typeof embedded === 'string') {
+        return embedded;
+    }
+    if (lastIoError) {
+        throw new errors.SuperDocCliError(`${label} could not be read: ${lastIoError.message}`, {
+            code: 'TOOLS_ASSET_UNREADABLE',
+            details: { triedPaths: tried, cause: `${lastIoError.code ?? lastIoError.name}: ${lastIoError.message}` },
+        });
+    }
+    throw new errors.SuperDocCliError(`${label} not found.`, {
+        code: 'TOOLS_ASSET_NOT_FOUND',
+        details: { triedPaths: tried },
+    });
+}
+function isRecord(value) {
+    return typeof value === 'object' && value != null && !Array.isArray(value);
+}
+function isObviouslyCorruptedToolArgKey(key) {
+    const trimmed = key.trim();
+    return trimmed.length === 0 || !/[\p{L}\p{N}]/u.test(trimmed);
+}
+function stripCorruptedToolArgKeys(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => stripCorruptedToolArgKeys(item));
+    }
+    if (!isRecord(value))
+        return value;
+    const clean = {};
+    for (const [key, entryValue] of Object.entries(value)) {
+        if (isObviouslyCorruptedToolArgKey(key))
+            continue;
+        clean[key] = stripCorruptedToolArgKeys(entryValue);
+    }
+    return clean;
+}
+function validateAgentToolArgs(toolName, args) {
+    const definition = catalog.AGENT_TOOL_DEFINITIONS.find((entry) => entry.name === toolName);
+    if (definition == null)
+        return;
+    const schema = definition.inputSchema;
+    const properties = isRecord(schema.properties) ? schema.properties : {};
+    const required = Array.isArray(schema.required) ? schema.required : [];
+    const knownKeys = new Set(Object.keys(properties));
+    const unknownKeys = Object.keys(args).filter((key) => !knownKeys.has(key));
+    if (unknownKeys.length > 0) {
+        throw new errors.SuperDocCliError(`Unknown argument(s) for ${toolName}: ${unknownKeys.join(', ')}`, {
+            code: 'INVALID_ARGUMENT',
+            details: { toolName, unknownKeys, knownKeys: [...knownKeys] },
+        });
+    }
+    const missingKeys = required.filter((key) => args[key] == null);
+    if (missingKeys.length > 0) {
+        throw new errors.SuperDocCliError(`Missing required argument(s) for ${toolName}: ${missingKeys.join(', ')}`, {
+            code: 'INVALID_ARGUMENT',
+            details: { toolName, missingKeys },
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Compaction helpers — keep agent receipts tight in the tool-result payload
+// ---------------------------------------------------------------------------
+/**
+ * Max entries for per-item receipt lists (executedOperations, selectedTargets).
+ * Receipts live in the conversation and are re-billed as prompt tokens on every
+ * subsequent turn; unbounded lists (one op per formatted range/paragraph) made
+ * single receipts cost thousands of tokens. 8 keeps enough shape to audit while
+ * the accompanying *Count field preserves the true total.
+ */
+const RECEIPT_LIST_CAP = 8;
+function compactCountMap(counts) {
+    const compact = {};
+    for (const [key, value] of Object.entries(counts)) {
+        if (typeof value === 'number' && value !== 0)
+            compact[key] = value;
+    }
+    if (Object.keys(compact).length === 0 && typeof counts.blocks === 'number') {
+        compact.blocks = counts.blocks;
+    }
+    return compact;
+}
+function pickScalarFields(value, keys, limit = 6) {
+    if (!isRecord(value))
+        return {};
+    const entries = keys
+        ? keys.filter((key) => key in value).map((key) => [key, value[key]])
+        : Object.entries(value);
+    const compact = {};
+    for (const [key, entryValue] of entries) {
+        if (typeof entryValue === 'string' ||
+            typeof entryValue === 'number' ||
+            typeof entryValue === 'boolean' ||
+            entryValue == null) {
+            compact[key] = entryValue ?? null;
+        }
+        if (Object.keys(compact).length >= limit)
+            break;
+    }
+    return compact;
+}
+function compactOperationResult(result) {
+    if (result == null || typeof result === 'string' || typeof result === 'number' || typeof result === 'boolean') {
+        return result;
+    }
+    if (Array.isArray(result))
+        return { itemCount: result.length };
+    if (!isRecord(result))
+        return { kind: typeof result };
+    const compact = {
+        ...pickScalarFields(result, ['success', 'status', 'count', 'total', 'applied', 'created', 'deleted']),
+    };
+    if (isRecord(result.revision)) {
+        const revision = pickScalarFields(result.revision, ['before', 'after', 'current']);
+        if (Object.keys(revision).length > 0)
+            compact.revision = revision;
+    }
+    if (Array.isArray(result.steps)) {
+        compact.stepCount = result.steps.length;
+        compact.steps = result.steps
+            .slice(0, 4)
+            .map((step) => (isRecord(step) ? pickScalarFields(step, ['stepId', 'op', 'effect', 'matchCount'], 4) : {}));
+    }
+    if (Array.isArray(result.items))
+        compact.itemCount = result.items.length;
+    if (Array.isArray(result.changes))
+        compact.changeCount = result.changes.length;
+    if (Array.isArray(result.matches))
+        compact.matchCount = result.matches.length;
+    if (Object.keys(compact).length === 0)
+        return { kind: 'object' };
+    return compact;
+}
+function compactAgentReceipt(receipt) {
+    // Compact the known heavy fields; pass every action-specific evidence field
+    // (editsApplied, marker, placement, revertHint, recovery, …) through
+    // verbatim — truth-telling receipts are only useful if the model sees them.
+    const { status, intent, preSnapshot, postSnapshot, selectedTargets, executedOperations, verification, saveReopen, errors, ...evidence } = receipt;
+    return {
+        status,
+        intent,
+        ...(preSnapshot
+            ? {
+                preSnapshot: {
+                    revision: preSnapshot.revision,
+                    ...(preSnapshot.counts ? { counts: compactCountMap(preSnapshot.counts) } : {}),
+                },
+            }
+            : {}),
+        ...(postSnapshot
+            ? {
+                postSnapshot: {
+                    revision: postSnapshot.revision,
+                    ...(postSnapshot.counts ? { counts: compactCountMap(postSnapshot.counts) } : {}),
+                },
+            }
+            : {}),
+        ...(selectedTargets
+            ? {
+                // Cap per-item lists: batch actions (add_comments selectors[],
+                // whole-body formatting) can select hundreds of targets, and the
+                // receipt is re-sent in conversation history on EVERY later turn.
+                // The count carries the evidence; the head carries the shape.
+                selectedTargets: selectedTargets.slice(0, RECEIPT_LIST_CAP).map((target) => ({
+                    selector: target.selector,
+                    matchedCount: target.matched.length,
+                })),
+                ...(selectedTargets.length > RECEIPT_LIST_CAP ? { selectedTargetCount: selectedTargets.length } : {}),
+            }
+            : {}),
+        ...(executedOperations
+            ? {
+                // Same cap: per-range/per-item actions (format_text on every
+                // occurrence, whole-body set_font_family) execute one op per item —
+                // an uncapped list dominates the token cost of the receipt.
+                executedOperations: executedOperations.slice(0, RECEIPT_LIST_CAP).map((operation) => ({
+                    operationId: operation.operationId,
+                    ...(operation.rationale ? { rationale: operation.rationale } : {}),
+                    ...(operation.result !== undefined ? { result: compactOperationResult(operation.result) } : {}),
+                })),
+                ...(executedOperations.length > RECEIPT_LIST_CAP
+                    ? { executedOperationCount: executedOperations.length }
+                    : {}),
+            }
+            : {}),
+        ...(verification
+            ? {
+                verificationPassed: verification.every((entry) => entry.passed),
+                verification: verification.map((entry) => ({
+                    check: pickScalarFields(entry.check, undefined, 6),
+                    passed: entry.passed,
+                    ...(entry.detail ? { detail: entry.detail } : {}),
+                })),
+            }
+            : {}),
+        ...(saveReopen ? { saveReopen } : {}),
+        ...(errors ? { errors } : {}),
+        ...evidence,
+    };
+}
+// ---------------------------------------------------------------------------
+// superdoc_execute_code — in-host dispatch for the CLI/SDK-only `doc.executeCode` op
+// ---------------------------------------------------------------------------
+const EXECUTE_CODE_SPEC = {
+    operationId: 'doc.executeCode',
+    commandTokens: ['execute', 'code'],
+    params: [
+        { name: 'sessionId', kind: 'flag', flag: 'session', type: 'string' },
+        { name: 'code', kind: 'flag', flag: 'code', type: 'string' },
+    ],
+};
+function asRawOperationCapable(documentHandle) {
+    const candidate = documentHandle;
+    if (typeof candidate.invokeRawOperation !== 'function') {
+        throw new errors.SuperDocCliError('superdoc_execute_code requires a session-bound document handle from client.open(); the provided handle cannot dispatch CLI/SDK-only operations.', {
+            code: 'TOOL_DISPATCH_NOT_FOUND',
+            details: { toolName: 'superdoc_execute_code' },
+        });
+    }
+    return candidate;
+}
+async function dispatchExecuteCode(documentHandle, args, invokeOptions) {
+    const code = typeof args.code === 'string' ? args.code : '';
+    // The generated bound client exposes doc.executeCode directly — use it.
+    // The invokeRawOperation path predates that binding and no handle produced
+    // by client.open() implements it; it remains only for callers that inject
+    // their own raw-capable handle.
+    const direct = documentHandle.executeCode;
+    if (typeof direct === 'function') {
+        return direct.call(documentHandle, { code }, invokeOptions);
+    }
+    const runner = asRawOperationCapable(documentHandle);
+    return runner.invokeRawOperation(EXECUTE_CODE_SPEC, { code }, invokeOptions);
+}
+// ---------------------------------------------------------------------------
+// Dispatcher
+// ---------------------------------------------------------------------------
+async function dispatchAgentTool(documentHandle, toolName, args, invokeOptions) {
+    switch (toolName) {
+        case 'superdoc_inspect':
+            return runtime.agentInspect(documentHandle, args);
+        case 'agent_apply':
+            return compactAgentReceipt(await runtime.agentApply(documentHandle, args));
+        case 'agent_verify':
+            return compactAgentReceipt(await runtime.agentVerify(documentHandle, args));
+        case 'agent_operation':
+            return runtime.agentOperation(documentHandle, args);
+        case 'superdoc_perform_action':
+            return compactAgentReceipt(await actions.superdocPerformAction(documentHandle, args));
+        case 'superdoc_execute_code':
+            return dispatchExecuteCode(documentHandle, args, invokeOptions);
+    }
+    throw new errors.SuperDocCliError(`Unknown agent tool: ${toolName}`, {
+        code: 'TOOL_DISPATCH_NOT_FOUND',
+        details: { toolName },
+    });
+}
+// ---------------------------------------------------------------------------
+// Provider cache markers — mirrors the legacy preset
+// ---------------------------------------------------------------------------
+function applyCacheMarkers(tools, provider, cacheRequested) {
+    if (!cacheRequested)
+        return { tools, cacheStrategy: 'disabled' };
+    if (provider === 'anthropic') {
+        if (tools.length === 0)
+            return { tools, cacheStrategy: 'explicit' };
+        const next = tools.slice(0, -1);
+        const last = {
+            ...tools[tools.length - 1],
+            cache_control: { type: 'ephemeral' },
+        };
+        next.push(last);
+        return { tools: next, cacheStrategy: 'explicit' };
+    }
+    if (provider === 'openai')
+        return { tools, cacheStrategy: 'automatic' };
+    return { tools, cacheStrategy: 'unsupported' };
+}
+// ---------------------------------------------------------------------------
+// PresetDescriptor surface
+// ---------------------------------------------------------------------------
+async function coreGetTools(provider, options) {
+    const tools = catalog.listAgentTools(provider, { excludeActions: options?.excludeActions });
+    return applyCacheMarkers(tools, provider, options?.cache === true);
+}
+async function coreGetCatalog() {
+    // Synthetic catalog — describes the advertised LLM-facing tools.
+    const publicSet = new Set(catalog.PUBLIC_AGENT_TOOL_NAMES);
+    const tools = catalog.AGENT_TOOL_DEFINITIONS.filter((d) => publicSet.has(d.name)).map((d) => ({
+        toolName: d.name,
+        description: d.description,
+        inputSchema: d.inputSchema,
+        mutates: d.name !== 'superdoc_inspect',
+        operations: [],
+    }));
+    return {
+        contractVersion: 'core/v2',
+        generatedAt: null,
+        toolCount: tools.length,
+        tools,
+    };
+}
+/**
+ * Drop the per-action documentation lines for excluded actions. Entries render
+ * as single "- name: ..." lines (the drift-guard test enforces the format), so
+ * line-level filtering is deterministic. Prose cross-references elsewhere in
+ * the prompt are left alone — a mention costs a few tokens; a full per-action
+ * manual for an uncallable action teaches the model to call it.
+ */
+function stripExcludedActionLines(prompt, excludedActions) {
+    if (excludedActions.size === 0)
+        return prompt;
+    return prompt
+        .split('\n')
+        .filter((line) => {
+        const match = /^- ([a-z_]+)(?: \/ ([a-z_]+))?:/.exec(line);
+        if (!match)
+            return true;
+        const names = [match[1], match[2]].filter((n) => Boolean(n));
+        // Drop the line only when EVERY action it documents is excluded (the
+        // paired accept/reject line survives if one side remains callable).
+        return !names.every((name) => excludedActions.has(name));
+    })
+        .join('\n');
+}
+async function coreGetSystemPrompt(options) {
+    const { excludedActions } = catalog.validateExclusions({ excludeActions: options?.excludeActions });
+    // The core preset is ACTIONS-ONLY: superdoc_execute_code is WIP and not
+    // advertised, and the prompt documents only the action surface (this exact
+    // prompt is what the eval suite validates). Code-execution guidance will be
+    // added when the safety-flag work ships that tool.
+    if (_actionsOnlyPromptCache == null) {
+        _actionsOnlyPromptCache = await readPromptFile('system-prompt.md', 'Core system prompt');
+    }
+    return stripExcludedActionLines(_actionsOnlyPromptCache, excludedActions);
+}
+async function coreGetMcpPrompt() {
+    if (_mcpPromptCache == null) {
+        _mcpPromptCache = await readPromptFile('mcp-prompt.md', 'MCP system prompt');
+    }
+    return _mcpPromptCache;
+}
+async function coreDispatch(documentHandle, toolName, args, invokeOptions) {
+    if (!isRecord(args)) {
+        throw new errors.SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
+            code: 'INVALID_ARGUMENT',
+            details: { toolName },
+        });
+    }
+    const sanitizedArgs = stripCorruptedToolArgKeys(args);
+    if (!isRecord(sanitizedArgs)) {
+        throw new errors.SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
+            code: 'INVALID_ARGUMENT',
+            details: { toolName },
+        });
+    }
+    // Defense-in-depth for exclusion configs: a host that narrowed the advertised
+    // surface (getTools excludeActions) can pass the same list here so a
+    // guessed/injected call to an excluded action is refused, not run.
+    const exclusionOptions = invokeOptions;
+    if (toolName === 'superdoc_perform_action' &&
+        typeof sanitizedArgs.action === 'string' &&
+        exclusionOptions?.excludeActions?.includes(sanitizedArgs.action)) {
+        throw new errors.SuperDocCliError(`Action ${sanitizedArgs.action} is excluded by configuration.`, {
+            code: 'INVALID_ARGUMENT',
+            details: { toolName, action: sanitizedArgs.action, excluded: true },
+        });
+    }
+    let forwardOptions = invokeOptions;
+    if (exclusionOptions && 'excludeActions' in exclusionOptions) {
+        const { excludeActions: _ea, ...rest } = exclusionOptions;
+        forwardOptions = rest;
+    }
+    if (catalog.isAgentToolName(toolName)) {
+        validateAgentToolArgs(toolName, sanitizedArgs);
+        return dispatchAgentTool(documentHandle, toolName, sanitizedArgs, forwardOptions);
+    }
+    throw new errors.SuperDocCliError(`Unknown tool: ${toolName}`, {
+        code: 'TOOL_DISPATCH_NOT_FOUND',
+        details: { toolName, preset: 'core' },
+    });
+}
+const corePreset = {
+    id: 'core',
+    description: 'Actions-only LLM surface: superdoc_inspect (reads) and superdoc_perform_action (named, deterministic edit verbs). superdoc_execute_code exists but is WIP — dispatchable, not advertised.',
+    supportsCacheControl: true,
+    getTools: coreGetTools,
+    getCatalog: coreGetCatalog,
+    getSystemPrompt: coreGetSystemPrompt,
+    getMcpPrompt: coreGetMcpPrompt,
+    dispatch: coreDispatch,
+};
+
+exports.corePreset = corePreset;
+exports.readPromptFile = readPromptFile;

package/dist/presets/core.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `core` preset — actions-only LLM-facing surface.
+ *
+ * Two advertised tools: superdoc_inspect (read-only deterministic snapshots)
+ * and superdoc_perform_action (named, statically validated, deterministic edit
+ * verbs — the action registry in agent/actions.ts).
+ *
+ * superdoc_execute_code (model-authored JS against a synchronous in-host doc)
+ * is WIP: dispatchable for SDK callers, NOT advertised and NOT in the served
+ * system prompt until it ships behind a safety flag. The agent_apply /
+ * agent_verify / agent_operation tools are likewise dispatchable but never
+ * advertised.
+ *
+ * @internal
+ */
+import type { PresetDescriptor } from '../presets.js';
+/** Exported for unit tests; production callers use the default candidates. */
+export declare function readPromptFile(fileName: string, label: string, candidateDirs?: readonly string[]): Promise<string>;
+export declare const corePreset: PresetDescriptor;
+//# sourceMappingURL=core.d.ts.map

package/dist/presets/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/presets/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkBH,OAAO,KAAK,EAKV,gBAAgB,EAIjB,MAAM,eAAe,CAAC;AAevB,8EAA8E;AAC9E,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,SAAS,MAAM,EAA0B,GACvD,OAAO,CAAC,MAAM,CAAC,CAmCjB;AAuaD,eAAO,MAAM,UAAU,EAAE,gBAWxB,CAAC"}