@tenonhq/dovetail-servicenow 0.0.17 → 0.0.19

package/README.md

@@ -221,6 +221,31 @@ live). The
 POST silently no-ops (stays draft). Sequence reverse-engineered from Workflow
 Studio HARs and validated live (2026-06-02, tenonworkstudio). Exit `0` published
 or dry-run; `2` created-but-not-published.
+### Create a table (with columns)
+
+```bash
+npx dove-sn create-table \
+  --name x_cadso_core_error --label Error --scope x_cadso_core \
+  --columns "Key:string:255, Severity:choice:50, First Seen On:datetime, Occurence Count:integer:5" \
+  --number-prefix ERR --user-role x_cadso_core.user --update-set <sys_id> --dry-run --json
+npx dove-sn create-table --from-json ./table.json   # full spec from a file
+```
+
+`create-table` mints a **brand-new** table (`sys_db_object`) **with its columns**.
+A table create is a privileged platform op — a REST / Dovetail `createRecord`
+insert into `sys_db_object` **orphans** the table (a metadata row with no physical
+table, no ACLs, no scope wiring). So this replays the Studio form save: a single
+`POST /sys_db_object.do` (form-login session → `g_ck`) whose body embeds every
+column as a `sys_dictionary` list-edit XML blob (one `<record operation="add">`
+per column) plus the Application-Navigator module — yielding the real 36-record
+graph + the physical table + seeded ACLs. Friendly column types are mapped to
+ServiceNow internal types (`string` → `string_full_utf8`, Studio's real String
+type). `--dry-run` returns the plan + the column XML + the projected graph with no
+session and no writes; the pure transforms are unit-tested. **The live write path
+is pending a validated-live spike** — prefer `--dry-run`, and always verify the
+`sys_update_xml` rows landed in the intended update set. Ground truth (the HAR
+dissection) lives in the CTO repo's create-table docs.
+
 `test-flow` defaults to **validate** — a safe pre-flight (published? inputs match
 declared variables?) that never runs the flow; `--execute --confirm` runs it via
 the server-side FlowAPI runner (deploy `resources/runFlow.md` first).

package/dist/cli.js

@@ -57,6 +57,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 const loadEnv_1 = require("./loadEnv");
 const client_1 = require("./client");
 const choices_1 = require("./choices");
@@ -77,6 +78,7 @@ const createFlow_1 = require("./flowDesigner/createFlow");
 const editFlow_1 = require("./flowDesigner/editFlow");
 const editActionType_1 = require("./flowDesigner/editActionType");
 const testFlow_1 = require("./flowDesigner/testFlow");
+const table_1 = require("./table");
 const flowDesigner_formatter_2 = require("./flowDesigner-formatter");
 function parseArgs(argv) {
     var command = argv[0] || "";
@@ -699,6 +701,11 @@ function printHelp() {
         "                     (--name <n> --template <sys_id> --scope <sys_id>\n" +
         "                      [--trigger-table <t>] [--trigger-condition <q>] [--log-message <m>]\n" +
         "                      [--internal-name <n>] [--description <d>] [--dry-run] [--json])\n" +
+        "  create-table       Create a NEW table (sys_db_object) WITH columns, via the Studio form save\n" +
+        "                     (--name <x_scope_t> --label <l> --scope <s>\n" +
+        "                      --columns \"Label:type:max, ...\"  OR  --from-json <spec.json>\n" +
+        "                      [--extends <t>] [--number-prefix <p>] [--user-role <r>]\n" +
+        "                      [--no-acls] [--no-menu] [--update-set <sys_id>] [--dry-run] [--json])\n" +
         "  test-flow          Validate (default) or run a flow/subflow\n" +
         "                     (--sys-id <sys_id> [--execute --confirm] [--inputs <json>] [--json])\n" +
         "  edit-flow          Patch a flow/subflow (rename, description, step inputs)\n" +
@@ -708,6 +715,92 @@ function printHelp() {
         "  --env <path>       Load credentials from a specific .env file (also --env-file,\n" +
         "                     or the DOVETAIL_ENV_FILE env var). Default: .env in the cwd.\n");
 }
+/** Parse inline `--columns "Label:type:max, Other:choice, ..."` into ColumnSpec[]. */
+function parseColumnsInline(input) {
+    var out = [];
+    if (!input)
+        return out;
+    var parts = input.split(",");
+    for (var i = 0; i < parts.length; i += 1) {
+        var piece = parts[i].trim();
+        if (!piece)
+            continue;
+        var seg = piece.split(":");
+        var label = (seg[0] || "").trim();
+        var type = (seg[1] || "string").trim();
+        var max = (seg[2] || "").trim();
+        if (!label)
+            continue;
+        var col = { label: label, type: type };
+        if (max)
+            col.max_length = max;
+        out.push(col);
+    }
+    return out;
+}
+/**
+ * dove-sn create-table:
+ *   --name x_cadso_core_error --label Error --scope x_cadso_core
+ *   --columns "Key:string:255, Severity:choice:50, Occurence Count:integer:5"
+ *   [--extends sys_metadata] [--number-prefix ERR] [--user-role x_cadso_core.user]
+ *   [--no-acls] [--no-menu] [--update-set <sys_id>] [--save-action <sys_id>]
+ *   [--from-json <spec.json>] [--dry-run] [--json]
+ */
+async function runCreateTable(flags) {
+    var spec = {};
+    if (flags["from-json"]) {
+        spec = JSON.parse(fs.readFileSync(path.resolve(flags["from-json"]), "utf8"));
+    }
+    var name = flags.name || spec.name;
+    var label = flags.label || spec.label;
+    var scope = flags.scope || spec.scope;
+    var columns = flags.columns ? parseColumnsInline(flags.columns) : (spec.columns || []);
+    if (!name || !label || !scope || columns.length === 0) {
+        process.stderr.write("create-table: --name, --label, --scope and --columns (or --from-json) are required\n");
+        return 1;
+    }
+    var params = {
+        client: (0, client_1.createClient)({}),
+        name: name,
+        label: label,
+        scope: scope,
+        columns: columns
+    };
+    var ext = flags.extends || spec.extendsTable;
+    if (ext)
+        params.extendsTable = ext;
+    var prefix = flags["number-prefix"] || spec.numberPrefix;
+    if (prefix)
+        params.numberPrefix = prefix;
+    var role = flags["user-role"] || spec.userRole;
+    if (role)
+        params.userRole = role;
+    if (flags["no-acls"] === "true" || spec.createAccessControls === false)
+        params.createAccessControls = false;
+    if (flags["no-menu"] === "true" || spec.showInMenu === false)
+        params.showInMenu = false;
+    var us = flags["update-set"] || spec.updateSetSysId;
+    if (us)
+        params.updateSetSysId = us;
+    var sa = flags["save-action"] || spec.saveActionSysId;
+    if (sa)
+        params.saveActionSysId = sa;
+    if (flags["dry-run"] === "true" || spec.dryRun === true)
+        params.dryRun = true;
+    var result = await (0, table_1.createTable)(params);
+    if (flags.json === "true") {
+        process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+    }
+    else {
+        process.stdout.write("[" + result.status + "] " + result.name + " (" + result.label + ") scope=" + result.scopeSysId
+            + " — " + result.columns + " columns, projected graph " + result.graph.total + " records"
+            + (result.tableSysId ? " — sys_id " + result.tableSysId : "")
+            + "\n" + result.note + "\n");
+    }
+    if (result.status === "failed")
+        return 2;
+    return 0;
+}
 async function main() {
     var parsed = parseArgs(process.argv.slice(2));
     // Load credentials before any command runs. `--env`/`--env-file` (or the
@@ -736,6 +829,9 @@ async function main() {
     if (parsed.command === "create-flow") {
         return await runCreateFlow(parsed.flags);
     }
+    if (parsed.command === "create-table") {
+        return await runCreateTable(parsed.flags);
+    }
     if (parsed.command === "test-flow") {
         return await runTestFlow(parsed.flags);
     }

package/dist/client.js

@@ -278,6 +278,17 @@ function createClient(config = {}) {
         },
         claude: {
             createRecord: async function (params) {
+                // Guard: a bare record insert into sys_db_object creates only an
+                // orphaned metadata row — no physical table and no ACLs. Table creation
+                // is a privileged platform operation that must run through the proper
+                // lifecycle, never a generic createRecord call.
+                if (params && params.table === "sys_db_object") {
+                    throw new Error("Refusing to insert sys_db_object via createRecord: a bare insert " +
+                        "orphans the table (no physical table or ACLs are created). " +
+                        "Create tables via the dove-sn create-table capability (in build), " +
+                        "or in Studio then run `dove refresh -s <scope>` to materialise " +
+                        "the new records locally.");
+                }
                 var data = await dovetailRequest("POST", "createRecord", params, null, "claude.createRecord(" + params.table + ")");
                 return data.result || data;
             },

package/dist/index.d.ts

@@ -17,3 +17,5 @@ export { sincPlugin } from "./plugin";
 export { listTemplates, verifyArtifact, cloneSubflow, cloneActionType, triggerPublication, publishActionType, editActionType, readFlow, readActionType, publishFlow, copyFlow, createFlow, buildPublishModel, editFlow, testFlow, DEFAULT_RUN_FLOW_PATH, generateSysId, topoSort, executeWritePlan, WriteOrderError } from "./flowDesigner";
 export type { TemplateRef, ListTemplatesParams, FlowKind, VerifyExpect, VerifyFound, VerifyFailure, VerifyReport, VerifyArtifactParams, CloneSubflowParams, CloneSubflowResult, CloneActionTypeParams, CloneActionTypeResult, TriggerPublicationParams, TriggerPublicationResult, PublishActionTypeParams, PublishActionTypeResult, EditActionTypeParams, EditActionTypeResult, EditActionTypeOps, ReadFlowParams, ReadFlowResult, FlowStep, FlowVariable, ReadActionTypeParams, ReadActionTypeResult, ActionIo, PublishFlowParams, PublishFlowResult, CopyFlowParams, CopyFlowResult, CreateFlowParams, CreateFlowResult, EditFlowParams, EditFlowResult, EditFlowOps, StepInputPatch, TestFlowParams, TestFlowResult, WriteOp, WriteOpResult } from "./flowDesigner";
 export type { ServiceNowClientConfig, ChoiceValue, ChoiceType, AddChoicesParams, AddChoicesResult, ChoiceActionResult, DictionaryRecord, UpdateSetRecord, LayoutAction, LayoutRecordResult, LayoutResult, CreateViewParams, CreateViewResult, FormSectionSpec, SetFormLayoutParams, SetListLayoutParams, SetRelatedListsParams } from "./types";
+export { createTable, projectTableGraph, buildColumnXml, normalizeColumns, resolveType, applyTableSaveOverlay, defaultAccessFlags, TYPE_MAP, DEFAULT_SUPER_CLASS, DEFAULT_SAVE_ACTION } from "./table";
+export type { CreateTableParams, CreateTableResult, TableGraph, NormalizedColumn, ColumnSpec, AccessFlags, OverlaySpec } from "./table";

package/dist/index.js

@@ -6,7 +6,7 @@
  * REST API so every change lands in the target update set and scope.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WriteOrderError = exports.executeWritePlan = exports.topoSort = exports.generateSysId = exports.DEFAULT_RUN_FLOW_PATH = exports.testFlow = exports.editFlow = exports.buildPublishModel = exports.createFlow = exports.copyFlow = exports.publishFlow = exports.readActionType = exports.readFlow = exports.editActionType = exports.publishActionType = exports.triggerPublication = exports.cloneActionType = exports.cloneSubflow = exports.verifyArtifact = exports.listTemplates = exports.sincPlugin = exports.formatCreateViewResult = exports.formatLayoutResult = exports.setRelatedLists = exports.setFormLayout = exports.setListLayout = exports.createView = exports.formatAddChoicesResult = exports.addChoicesToField = exports.createClient = void 0;
+exports.DEFAULT_SAVE_ACTION = exports.DEFAULT_SUPER_CLASS = exports.TYPE_MAP = exports.defaultAccessFlags = exports.applyTableSaveOverlay = exports.resolveType = exports.normalizeColumns = exports.buildColumnXml = exports.projectTableGraph = exports.createTable = exports.WriteOrderError = exports.executeWritePlan = exports.topoSort = exports.generateSysId = exports.DEFAULT_RUN_FLOW_PATH = exports.testFlow = exports.editFlow = exports.buildPublishModel = exports.createFlow = exports.copyFlow = exports.publishFlow = exports.readActionType = exports.readFlow = exports.editActionType = exports.publishActionType = exports.triggerPublication = exports.cloneActionType = exports.cloneSubflow = exports.verifyArtifact = exports.listTemplates = exports.sincPlugin = exports.formatCreateViewResult = exports.formatLayoutResult = exports.setRelatedLists = exports.setFormLayout = exports.setListLayout = exports.createView = exports.formatAddChoicesResult = exports.addChoicesToField = exports.createClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return client_1.createClient; } });
 var choices_1 = require("./choices");
@@ -47,3 +47,14 @@ Object.defineProperty(exports, "generateSysId", { enumerable: true, get: functio
 Object.defineProperty(exports, "topoSort", { enumerable: true, get: function () { return flowDesigner_1.topoSort; } });
 Object.defineProperty(exports, "executeWritePlan", { enumerable: true, get: function () { return flowDesigner_1.executeWritePlan; } });
 Object.defineProperty(exports, "WriteOrderError", { enumerable: true, get: function () { return flowDesigner_1.WriteOrderError; } });
+var table_1 = require("./table");
+Object.defineProperty(exports, "createTable", { enumerable: true, get: function () { return table_1.createTable; } });
+Object.defineProperty(exports, "projectTableGraph", { enumerable: true, get: function () { return table_1.projectTableGraph; } });
+Object.defineProperty(exports, "buildColumnXml", { enumerable: true, get: function () { return table_1.buildColumnXml; } });
+Object.defineProperty(exports, "normalizeColumns", { enumerable: true, get: function () { return table_1.normalizeColumns; } });
+Object.defineProperty(exports, "resolveType", { enumerable: true, get: function () { return table_1.resolveType; } });
+Object.defineProperty(exports, "applyTableSaveOverlay", { enumerable: true, get: function () { return table_1.applyTableSaveOverlay; } });
+Object.defineProperty(exports, "defaultAccessFlags", { enumerable: true, get: function () { return table_1.defaultAccessFlags; } });
+Object.defineProperty(exports, "TYPE_MAP", { enumerable: true, get: function () { return table_1.TYPE_MAP; } });
+Object.defineProperty(exports, "DEFAULT_SUPER_CLASS", { enumerable: true, get: function () { return table_1.DEFAULT_SUPER_CLASS; } });
+Object.defineProperty(exports, "DEFAULT_SAVE_ACTION", { enumerable: true, get: function () { return table_1.DEFAULT_SAVE_ACTION; } });

package/dist/mcp/registry.d.ts

@@ -10,7 +10,7 @@ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import type { ToolAnnotations } from "@tenonhq/dovetail-mcp-kit";
 import type { ServiceNowClient } from "../client";
-export declare var TOOL_NAMES: readonly ["create_view", "set_list_layout", "set_form_layout", "set_related_lists", "add_choices_to_field", "flow_view", "action_view", "flow_publish", "flow_copy", "flow_create", "flow_test", "flow_edit"];
+export declare var TOOL_NAMES: readonly ["create_view", "set_list_layout", "set_form_layout", "set_related_lists", "add_choices_to_field", "flow_view", "action_view", "flow_publish", "flow_copy", "flow_create", "flow_test", "flow_edit", "create_table"];
 export type ToolName = typeof TOOL_NAMES[number];
 export interface RegistryDeps {
     /** Optional client injection for tests; defaults to createClient({}). */

package/dist/mcp/registry.js

@@ -25,6 +25,7 @@ const copyFlow_1 = require("../flowDesigner/copyFlow");
 const createFlow_1 = require("../flowDesigner/createFlow");
 const editFlow_1 = require("../flowDesigner/editFlow");
 const testFlow_1 = require("../flowDesigner/testFlow");
+const table_1 = require("../table");
 const schemas_1 = require("./schemas");
 exports.TOOL_NAMES = [
     "create_view",
@@ -38,7 +39,8 @@ exports.TOOL_NAMES = [
     "flow_copy",
     "flow_create",
     "flow_test",
-    "flow_edit"
+    "flow_edit",
+    "create_table"
 ];
 // Annotation presets (READ_ONLY / WRITE_ADDITIVE_IDEMPOTENT / WRITE_CREATE /
 // WRITE_OVERWRITE / WRITE_EXECUTE) come from @tenonhq/dovetail-mcp-kit.
@@ -227,6 +229,40 @@ function buildDescriptors(deps = {}) {
                     updateSetSysId: p.updateSetSysId
                 });
             }
+        },
+        {
+            name: "create_table",
+            annotations: dovetail_mcp_kit_1.WRITE_CREATE,
+            description: "Create a NEW ServiceNow table (sys_db_object) WITH its columns, headless and faithfully. "
+                + "A table create is a privileged platform op — a REST/createRecord insert ORPHANS the table "
+                + "(metadata row, no physical table, no ACLs). This replays the Studio form save "
+                + "(POST /sys_db_object.do) so the real 36-record graph + the physical table + seeded ACLs "
+                + "are created. name (x_scope_*), label, scope, and columns[] are required; extendsTable "
+                + "defaults to sys_metadata; friendly column types are mapped to internal types "
+                + "(string -> string_full_utf8). dryRun:true returns the plan + the column XML + the projected "
+                + "graph with no session and no writes. NOTE: the live write path is pending a validated-live "
+                + "spike — prefer dryRun until confirmed, and always verify the sys_update_xml landed in the "
+                + "intended update set.",
+            shape: schemas_1.createTableSchema.shape,
+            handler: async function (args) {
+                var p = schemas_1.createTableSchema.parse(args);
+                return (0, table_1.createTable)({
+                    client: client(),
+                    name: p.name,
+                    label: p.label,
+                    scope: p.scope,
+                    columns: p.columns,
+                    extendsTable: p.extendsTable,
+                    numberPrefix: p.numberPrefix,
+                    userRole: p.userRole,
+                    createAccessControls: p.createAccessControls,
+                    access: p.access,
+                    showInMenu: p.showInMenu,
+                    updateSetSysId: p.updateSetSysId,
+                    saveActionSysId: p.saveActionSysId,
+                    dryRun: p.dryRun
+                });
+            }
         }
     ];
 }

package/dist/mcp/schemas.d.ts

@@ -382,3 +382,95 @@ export declare var editFlowSchema: z.ZodObject<{
     updateSetSysId?: string | undefined;
     apply?: boolean | undefined;
 }>;
+export declare var columnSpecSchema: z.ZodObject<{
+    label: z.ZodString;
+    type: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    max_length: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    reference: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    label: string;
+    name?: string | undefined;
+    max_length?: string | number | undefined;
+    reference?: string | undefined;
+}, {
+    type: string;
+    label: string;
+    name?: string | undefined;
+    max_length?: string | number | undefined;
+    reference?: string | undefined;
+}>;
+export declare var createTableSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+    scope: z.ZodString;
+    columns: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        type: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        max_length: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        reference: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        label: string;
+        name?: string | undefined;
+        max_length?: string | number | undefined;
+        reference?: string | undefined;
+    }, {
+        type: string;
+        label: string;
+        name?: string | undefined;
+        max_length?: string | number | undefined;
+        reference?: string | undefined;
+    }>, "many">;
+    extendsTable: z.ZodOptional<z.ZodString>;
+    numberPrefix: z.ZodOptional<z.ZodString>;
+    userRole: z.ZodOptional<z.ZodString>;
+    createAccessControls: z.ZodOptional<z.ZodBoolean>;
+    access: z.ZodOptional<z.ZodString>;
+    showInMenu: z.ZodOptional<z.ZodBoolean>;
+    updateSetSysId: z.ZodOptional<z.ZodString>;
+    saveActionSysId: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    columns: {
+        type: string;
+        label: string;
+        name?: string | undefined;
+        max_length?: string | number | undefined;
+        reference?: string | undefined;
+    }[];
+    label: string;
+    scope: string;
+    dryRun?: boolean | undefined;
+    updateSetSysId?: string | undefined;
+    extendsTable?: string | undefined;
+    numberPrefix?: string | undefined;
+    userRole?: string | undefined;
+    createAccessControls?: boolean | undefined;
+    access?: string | undefined;
+    showInMenu?: boolean | undefined;
+    saveActionSysId?: string | undefined;
+}, {
+    name: string;
+    columns: {
+        type: string;
+        label: string;
+        name?: string | undefined;
+        max_length?: string | number | undefined;
+        reference?: string | undefined;
+    }[];
+    label: string;
+    scope: string;
+    dryRun?: boolean | undefined;
+    updateSetSysId?: string | undefined;
+    extendsTable?: string | undefined;
+    numberPrefix?: string | undefined;
+    userRole?: string | undefined;
+    createAccessControls?: boolean | undefined;
+    access?: string | undefined;
+    showInMenu?: boolean | undefined;
+    saveActionSysId?: string | undefined;
+}>;

package/dist/mcp/schemas.js

@@ -4,7 +4,7 @@
  * own file so registry.ts stays focused on wiring.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.editFlowSchema = exports.stepInputPatchSchema = exports.testFlowSchema = exports.createFlowSchema = exports.copyFlowSchema = exports.publishFlowSchema = exports.viewActionSchema = exports.viewFlowSchema = exports.addChoicesToFieldSchema = exports.choiceValueSchema = exports.setRelatedListsSchema = exports.setFormLayoutSchema = exports.formSectionSchema = exports.setListLayoutSchema = exports.createViewSchema = void 0;
+exports.createTableSchema = exports.columnSpecSchema = exports.editFlowSchema = exports.stepInputPatchSchema = exports.testFlowSchema = exports.createFlowSchema = exports.copyFlowSchema = exports.publishFlowSchema = exports.viewActionSchema = exports.viewFlowSchema = exports.addChoicesToFieldSchema = exports.choiceValueSchema = exports.setRelatedListsSchema = exports.setFormLayoutSchema = exports.formSectionSchema = exports.setListLayoutSchema = exports.createViewSchema = void 0;
 const zod_1 = require("zod");
 exports.createViewSchema = zod_1.z.object({
     name: zod_1.z.string().min(1),
@@ -113,3 +113,25 @@ exports.editFlowSchema = zod_1.z.object({
     scopeSysId: zod_1.z.string().optional(),
     updateSetSysId: zod_1.z.string().optional()
 });
+exports.columnSpecSchema = zod_1.z.object({
+    label: zod_1.z.string().min(1),
+    type: zod_1.z.string().min(1),
+    name: zod_1.z.string().optional(),
+    max_length: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).optional(),
+    reference: zod_1.z.string().optional()
+});
+exports.createTableSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1),
+    label: zod_1.z.string().min(1),
+    scope: zod_1.z.string().min(1),
+    columns: zod_1.z.array(exports.columnSpecSchema).min(1),
+    extendsTable: zod_1.z.string().optional(),
+    numberPrefix: zod_1.z.string().optional(),
+    userRole: zod_1.z.string().optional(),
+    createAccessControls: zod_1.z.boolean().optional(),
+    access: zod_1.z.string().optional(),
+    showInMenu: zod_1.z.boolean().optional(),
+    updateSetSysId: zod_1.z.string().optional(),
+    saveActionSysId: zod_1.z.string().optional(),
+    dryRun: zod_1.z.boolean().optional()
+});

package/dist/table/buildColumnXml.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Build the embedded list-edit column XML that rides inside the sys_db_object.do
+ * table-save POST. This is the ONE place ServiceNow's Studio form encodes new
+ * columns: a `<record_update table="sys_dictionary">` envelope with one
+ * `<record operation="add">` per column. Ground truth: a real Studio table-create
+ * HAR (`x_cadso_core_error`, tenonworkstudio, 2026-06-13) — see
+ * CTO docs/servicenow-create-table-har-analysis.md.
+ *
+ * Pure + deterministic (callers pass the per-column sys_ids) so it is unit-tested
+ * without a network. ES6 only, no optional chaining.
+ */
+/** A normalized column ready to render. `type` is the ServiceNow internal_type. */
+export interface NormalizedColumn {
+    /** Display label (Studio derives `element` from this server-side). */
+    label: string;
+    /** sys_dictionary.internal_type, e.g. "string_full_utf8", "choice", "integer". */
+    type: string;
+    /** max_length as a string; "" when the type carries none (e.g. glide_date_time). */
+    maxLength: string;
+    /** Reference target table for type "reference"; "" otherwise (rendered as NULL). */
+    reference: string;
+}
+/** Minimal XML-attr/text escaping — the values cross an XML boundary. */
+export declare function xmlEscape(s: string): string;
+/**
+ * Build the full `<record_update>` column blob. `sysIds[i]` is the fresh
+ * client-generated sys_id for column i (length must match `columns`).
+ */
+export declare function buildColumnXml(columns: Array<NormalizedColumn>, sysIds: Array<string>): string;

package/dist/table/buildColumnXml.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Build the embedded list-edit column XML that rides inside the sys_db_object.do
+ * table-save POST. This is the ONE place ServiceNow's Studio form encodes new
+ * columns: a `<record_update table="sys_dictionary">` envelope with one
+ * `<record operation="add">` per column. Ground truth: a real Studio table-create
+ * HAR (`x_cadso_core_error`, tenonworkstudio, 2026-06-13) — see
+ * CTO docs/servicenow-create-table-har-analysis.md.
+ *
+ * Pure + deterministic (callers pass the per-column sys_ids) so it is unit-tested
+ * without a network. ES6 only, no optional chaining.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.xmlEscape = xmlEscape;
+exports.buildColumnXml = buildColumnXml;
+/**
+ * The 14 per-record fields Studio submits, in the HAR's exact order. Most are
+ * static (server fills them); only column_label, internal_type, reference and
+ * max_length carry capability data.
+ */
+function renderRecord(col, sysId) {
+    var hasMax = col.maxLength !== "";
+    var ref = col.reference ? col.reference : "NULL";
+    var parts = [];
+    parts.push('<record sys_id="' + sysId + '" operation="add">');
+    // column_label — the only field the user really types; element is derived from it.
+    parts.push(field("column_label", { modified: true, dsp_set: true, value: "", display: col.label }));
+    parts.push(field("element", { value: "" }));
+    parts.push(field("internal_type", { modified: true, value_set: true, value: col.type }));
+    parts.push(field("reference", { value: ref }));
+    if (hasMax) {
+        parts.push(field("max_length", { modified: true, dsp_set: true, value: "", display: col.maxLength }));
+    }
+    else {
+        parts.push(field("max_length", { value: "" }));
+    }
+    parts.push(field("default_value", { value: "" }));
+    parts.push(field("display", { value: "false" }));
+    parts.push(field("sys_updated_on", { value: "" }));
+    parts.push(field("sys_updated_by", { value: "" }));
+    parts.push(field("attributes", { value: "" }));
+    parts.push(field("read_only", { value: "false" }));
+    parts.push(field("sys_created_on", { value: "" }));
+    parts.push(field("sys_created_by", { value: "" }));
+    parts.push(field("name", { value: "" }));
+    parts.push("</record>");
+    return parts.join("");
+}
+function field(name, opts) {
+    var modified = opts.modified === true ? "true" : "false";
+    var valueSet = opts.value_set === true ? "true" : "false";
+    var dspSet = opts.dsp_set === true ? "true" : "false";
+    var inner = "<value>" + xmlEscape(opts.value) + "</value>";
+    if (opts.dsp_set === true) {
+        inner += "<display_value>" + xmlEscape(opts.display === undefined ? "" : opts.display) + "</display_value>";
+    }
+    return '<field name="' + name + '" modified="' + modified
+        + '" value_set="' + valueSet + '" dsp_set="' + dspSet + '">' + inner + "</field>";
+}
+/** Minimal XML-attr/text escaping — the values cross an XML boundary. */
+function xmlEscape(s) {
+    return String(s)
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/**
+ * Build the full `<record_update>` column blob. `sysIds[i]` is the fresh
+ * client-generated sys_id for column i (length must match `columns`).
+ */
+function buildColumnXml(columns, sysIds) {
+    if (!Array.isArray(columns)) {
+        throw new Error("buildColumnXml: columns must be an array.");
+    }
+    if (!Array.isArray(sysIds) || sysIds.length !== columns.length) {
+        throw new Error("buildColumnXml: need exactly one sys_id per column (got "
+            + (Array.isArray(sysIds) ? sysIds.length : "none") + " for " + columns.length + " columns).");
+    }
+    var open = '<record_update table="sys_dictionary" field="null" query="nameONE IN^element!=NULL^ORDERBYelement">';
+    var body = "";
+    for (var i = 0; i < columns.length; i += 1) {
+        body += renderRecord(columns[i], sysIds[i]);
+    }
+    return open + body + "</record_update>";
+}

package/dist/table/buildTableSave.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Pure transforms for the table-save form POST: normalize a friendly column spec
+ * into ServiceNow internal types, and overlay the capability's values onto the
+ * fields harvested from the live new-record form.
+ *
+ * The transport (GET the new-record form, harvest fields, POST) lives in
+ * createTable.ts; everything here is deterministic and unit-tested. ES6 only.
+ */
+import { NormalizedColumn } from "./buildColumnXml";
+/** Friendly input column (what a caller / MCP tool passes). */
+export interface ColumnSpec {
+    name?: string;
+    label: string;
+    type: string;
+    max_length?: string | number;
+    reference?: string;
+}
+/**
+ * Friendly column type -> ServiceNow internal_type. Studio's default for a
+ * "String" is `string_full_utf8`, NOT plain `string` (confirmed in the HAR), so
+ * a caller saying "string" gets the type the platform actually writes.
+ */
+export declare var TYPE_MAP: Record<string, string>;
+/** Resolve a friendly-or-internal type string to the internal_type to write. */
+export declare function resolveType(type: string): string;
+/** Validate + normalize the friendly column list. Throws on the broken cases. */
+export declare function normalizeColumns(cols: Array<ColumnSpec>): Array<NormalizedColumn>;
+/** Per-operation access flags; all default true (matches Studio's create defaults). */
+export interface AccessFlags {
+    read: boolean;
+    create: boolean;
+    update: boolean;
+    delete: boolean;
+    ws: boolean;
+    configuration: boolean;
+    alter: boolean;
+    actions: boolean;
+    client_scripts: boolean;
+}
+export declare function defaultAccessFlags(): AccessFlags;
+/** Everything the overlay needs that the new-record form can't supply. */
+export interface OverlaySpec {
+    name: string;
+    label: string;
+    tableSysId: string;
+    saveActionSysId: string;
+    superClassSysId: string;
+    superClassLabel: string;
+    scopeSysId: string;
+    scopeLabel: string;
+    numberPrefix: string;
+    userRoleSysId: string;
+    userRoleLabel: string;
+    createAccessControls: boolean;
+    access: string;
+    accessFlags: AccessFlags;
+    /** Application sys_id for the nav module; "" disables Show-in-menu. */
+    selectedApplicationSysId: string;
+    menuName: string;
+    /** The discovered `ni.java...ListEditFormatterAction[sys_db_object.REL:<relId>]` key. */
+    listEditKey: string;
+    columnXml: string;
+}
+/** Build the `...ShowInMenuFormatterAction[<part>]` form key. */
+export declare function showInMenuKey(part: string): string;
+/** Build the `...ListEditFormatterAction[sys_db_object.REL:<relId>]` form key. */
+export declare function listEditKey(relId: string): string;
+/**
+ * Overlay the capability's values onto the base field map harvested from the live
+ * new-record form. Returns a NEW object (base is not mutated). Sets exactly the
+ * keys Studio mutates for a table create; everything else (sysparm_ck,
+ * sysparm_encoded_record, the dynamic `<sysid>_text` field, all sys_original.*
+ * defaults) is preserved from the harvested form.
+ */
+export declare function applyTableSaveOverlay(base: Record<string, string>, o: OverlaySpec): Record<string, string>;