@tenonhq/dovetail-servicenow 0.0.28 → 0.0.29

package/dist/choices.d.ts

@@ -9,6 +9,7 @@
  */
 import type { ServiceNowClient } from "./client";
 import type { AddChoicesParams, AddChoicesResult } from "./types";
+export declare function encodeQueryValue(v: string): string;
 /**
  * Upsert choices for a field and (optionally) toggle sys_dictionary.choice.
  * Idempotent: re-running with the same inputs returns `action: "unchanged"`

package/dist/choices.js

@@ -9,6 +9,7 @@
  * so choices stay in the same application as the field.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeQueryValue = encodeQueryValue;
 exports.addChoicesToField = addChoicesToField;
 function encodeQueryValue(v) {
     // ServiceNow encoded-query values: commas/carets/equals are special. We
@@ -39,7 +40,10 @@ async function resolveScopeName(client, scopeSysId) {
 async function fetchDictionary(client, table, column) {
     var rows = await client.table.query("sys_dictionary", "name=" + encodeQueryValue(table) + "^element=" + encodeQueryValue(column), 1);
     if (rows.length === 0) {
-        throw new Error("sys_dictionary record not found for " + table + "." + column +
+        throw new Error("sys_dictionary record not found for " +
+            table +
+            "." +
+            column +
             " — verify the field exists and your user has read access.");
     }
     var row = rows[0];
@@ -53,7 +57,7 @@ async function fetchDictionary(client, table, column) {
         name: row.name,
         element: row.element,
         choice: String(row.choice || "0"),
-        sys_scope: scope || ""
+        sys_scope: scope || "",
     };
 }
 async function fetchUpdateSet(client, sysId) {
@@ -63,14 +67,16 @@ async function fetchUpdateSet(client, sysId) {
     }
     var row = rows[0];
     if (row.state && row.state !== "in progress" && row.state !== "in_progress") {
-        throw new Error("Update set " + row.name + " is in state '" + row.state +
+        throw new Error("Update set " +
+            row.name +
+            " is in state '" +
+            row.state +
             "' — only 'in progress' update sets can capture new changes.");
     }
     return row;
 }
 async function fetchExistingChoices(client, table, column) {
-    return client.table.query("sys_choice", "name=" + encodeQueryValue(table) +
-        "^element=" + encodeQueryValue(column), 1000);
+    return client.table.query("sys_choice", "name=" + encodeQueryValue(table) + "^element=" + encodeQueryValue(column), 1000);
 }
 function buildChoiceFields(table, column, choice, scope) {
     var fields = {
@@ -79,7 +85,7 @@ function buildChoiceFields(table, column, choice, scope) {
         value: choice.value,
         label: choice.label,
         language: choice.language || "en",
-        inactive: "false"
+        inactive: "false",
     };
     if (choice.sequence != null) {
         fields.sequence = String(choice.sequence);
@@ -114,7 +120,9 @@ async function addChoicesToField(client, params) {
     var scopeName = await resolveScopeName(client, dict.sys_scope);
     var targetChoiceType = params.choiceType === null
         ? Number(dict.choice)
-        : (params.choiceType != null ? params.choiceType : 3);
+        : params.choiceType != null
+            ? params.choiceType
+            : 3;
     var choiceWas = Number(dict.choice);
     var choiceNow = choiceWas;
     if (params.choiceType !== null && Number(dict.choice) !== targetChoiceType) {
@@ -122,7 +130,7 @@ async function addChoicesToField(client, params) {
             update_set_sys_id: params.updateSetSysId,
             table: "sys_dictionary",
             record_sys_id: dict.sys_id,
-            fields: { choice: String(targetChoiceType) }
+            fields: { choice: String(targetChoiceType) },
         });
         choiceNow = targetChoiceType;
     }
@@ -138,14 +146,19 @@ async function addChoicesToField(client, params) {
         var key = (choice.language || "en") + "::" + choice.value;
         var match = existingByValue[key];
         if (match && isUnchanged(match, choice)) {
-            results.push({ value: choice.value, label: choice.label, sysId: match.sys_id, action: "unchanged" });
+            results.push({
+                value: choice.value,
+                label: choice.label,
+                sysId: match.sys_id,
+                action: "unchanged",
+            });
             continue;
         }
         if (match) {
             var updFields = {
                 label: choice.label,
                 language: choice.language || "en",
-                inactive: "false"
+                inactive: "false",
             };
             if (choice.sequence != null) {
                 updFields.sequence = String(choice.sequence);
@@ -154,22 +167,27 @@ async function addChoicesToField(client, params) {
                 update_set_sys_id: params.updateSetSysId,
                 table: "sys_choice",
                 record_sys_id: match.sys_id,
-                fields: updFields
+                fields: updFields,
+            });
+            results.push({
+                value: choice.value,
+                label: choice.label,
+                sysId: match.sys_id,
+                action: "updated",
             });
-            results.push({ value: choice.value, label: choice.label, sysId: match.sys_id, action: "updated" });
             continue;
         }
         var created = await client.claude.createRecord({
             table: "sys_choice",
             fields: buildChoiceFields(params.table, params.column, choice, dict.sys_scope),
             scope: scopeName,
-            update_set_sys_id: params.updateSetSysId
+            update_set_sys_id: params.updateSetSysId,
         });
         results.push({
             value: choice.value,
             label: choice.label,
             sysId: created.sys_id,
-            action: "created"
+            action: "created",
         });
     }
     return {
@@ -177,9 +195,9 @@ async function addChoicesToField(client, params) {
             sysId: dict.sys_id,
             scope: dict.sys_scope,
             choiceWas: choiceWas,
-            choiceNow: choiceNow
+            choiceNow: choiceNow,
         },
         updateSet: { sysId: updateSet.sys_id, name: updateSet.name },
-        choices: results
+        choices: results,
     };
 }

package/dist/cli.js

@@ -87,24 +87,30 @@ const flowDesigner_formatter_2 = require("./flowDesigner-formatter");
 function parseArgs(argv) {
     var command = argv[0] || "";
     var flags = {};
+    var bare = {};
     for (var i = 1; i < argv.length; i += 1) {
         var arg = argv[i];
         if (arg.indexOf("--") !== 0)
             continue;
         var key = arg.slice(2);
         var value = "true";
+        var isBare = true;
         var eq = key.indexOf("=");
         if (eq !== -1) {
             value = key.slice(eq + 1);
             key = key.slice(0, eq);
+            isBare = false;
         }
         else if (i + 1 < argv.length && argv[i + 1].indexOf("--") !== 0) {
             value = argv[i + 1];
             i += 1;
+            isBare = false;
         }
         flags[key] = value;
+        if (isBare)
+            bare[key] = true;
     }
-    return { command: command, flags: flags };
+    return { command: command, flags: flags, bare: bare };
 }
 function parseChoicesInline(input) {
     return input.split(",").map(function (pair) {
@@ -876,6 +882,17 @@ function printHelp() {
         "                      [--name <element>] [--max-length <n>] [--reference <table>]\n" +
         "                      [--mandatory] [--default <v>] [--scope <s>] [--dry-run] [--json])\n" +
         "                     --update-set is REQUIRED on the live path (not for --dry-run).\n" +
+        "  set-column         Update an EXISTING column's SCHEMA (label/mandatory/default/read-only/max-length),\n" +
+        "                     into an update set, then verify against the instance\n" +
+        "                     (--table <t> --column <c> --update-set <sys_id>\n" +
+        "                      [--label <l>] [--mandatory true|false] [--default <v>]\n" +
+        "                      [--read-only true|false] [--max-length <n>]\n" +
+        "                      [--dry-run] [--json])\n" +
+        "                     A max-length SHRINK is REFUSED while rows hold longer values —\n" +
+        "                     ServiceNow silently ignores such a shrink (200 OK, no change).\n" +
+        "                     Shorten or clear those values first, then re-run.\n" +
+        "                     --element / --internal-type are REFUSED with an explanation:\n" +
+        "                     ServiceNow silently ignores both on an existing column.\n" +
         "  invoke-rest        Invoke an arbitrary authenticated REST operation (Scripted REST incl.)\n" +
         "                     DRY-RUN BY DEFAULT — nothing is sent without --confirm\n" +
         "                     (--method <GET|POST|PUT|DELETE> --path /api/<scope>/<service>/<resource>\n" +
@@ -1087,6 +1104,111 @@ async function runAddColumn(flags) {
         return 2;
     return 0;
 }
+/** Parse a CLI boolean flag. Bare `--mandatory` means true; `--mandatory false` means
+ *  false. Anything else is rejected rather than quietly coerced to `true`. */
+function parseBoolFlag(name, raw) {
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    throw new Error("set-column: --" + name + " must be true or false (got '" + raw + "').");
+}
+/**
+ * dove-sn set-column:
+ *   --table x_cadso_journey --column description --update-set <sys_id>
+ *   [--label "Description"] [--mandatory true|false] [--default <v>]
+ *   [--read-only true|false] [--max-length 4000] [--dry-run] [--json]
+ *
+ * Updates an EXISTING column's schema. `internal_type` and a rename are refused —
+ * ServiceNow silently ignores both on an existing column. To CREATE one, use add-column;
+ * to set a RECORD's value, use set-field.
+ */
+async function runSetColumn(flags, bare) {
+    // A string flag whose value was forgotten arrives as the literal "true" — `--label`
+    // with nothing after it would rename the column to "true". Booleans legitimately do
+    // that, strings never do, so refuse rather than silently write nonsense.
+    var stringFlags = ["label", "default", "table", "column", "update-set"];
+    for (var f = 0; f < stringFlags.length; f += 1) {
+        if (bare[stringFlags[f]]) {
+            process.stderr.write("set-column: --" +
+                stringFlags[f] +
+                " needs a value (it was given none).\n");
+            return 1;
+        }
+    }
+    var table = flags.table;
+    var column = flags.column;
+    if (!table || !column) {
+        process.stderr.write("set-column: --table and --column are required " +
+            "(--update-set is required too, unless --dry-run)\n");
+        return 1;
+    }
+    var attributes = {};
+    // Accepted so that setColumn can REFUSE them by name with the reason. Dropping them
+    // silently would leave someone who asked for a rename believing it happened.
+    if (flags.element !== undefined)
+        attributes.element = flags.element;
+    if (flags["internal-type"] !== undefined) {
+        attributes.internalType = flags["internal-type"];
+    }
+    if (flags.label !== undefined)
+        attributes.label = flags.label;
+    if (flags.default !== undefined)
+        attributes.default = flags.default;
+    if (flags.mandatory !== undefined) {
+        attributes.mandatory = parseBoolFlag("mandatory", flags.mandatory);
+    }
+    if (flags["read-only"] !== undefined) {
+        attributes.readOnly = parseBoolFlag("read-only", flags["read-only"]);
+    }
+    if (flags["max-length"] !== undefined) {
+        var len = Number(flags["max-length"]);
+        // sys_dictionary.max_length is an integer; the MCP schema enforces int() too.
+        if (!Number.isInteger(len) || len < 1) {
+            process.stderr.write("set-column: --max-length must be a positive integer\n");
+            return 1;
+        }
+        attributes.maxLength = len;
+    }
+    var params = {
+        client: (0, client_1.createClient)({}),
+        table: table,
+        column: column,
+        attributes: attributes,
+    };
+    // Accept the same alias pair as the other verbs (create-view, set-list-layout, …).
+    var setColumnUs = flags["update-set"] || flags.updateSetSysId;
+    if (setColumnUs)
+        params.updateSetSysId = setColumnUs;
+    if (flags["dry-run"] === "true")
+        params.dryRun = true;
+    var result = await (0, table_1.setColumn)(params);
+    if (flags.json === "true") {
+        process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+    }
+    else {
+        process.stdout.write("[" +
+            result.status +
+            "] " +
+            result.table +
+            "." +
+            result.column +
+            (result.verified && result.status === "applied" ? " — verified" : "") +
+            (result.status === "applied" && !result.capturedInUpdateSet
+                ? " — NOT CAPTURED"
+                : "") +
+            "\n" +
+            result.note +
+            "\n");
+    }
+    // 2 = the write landed but the instance does not reflect it (or it was not captured),
+    // which must not read as success to a script.
+    if (result.status === "failed")
+        return 2;
+    if (result.status === "applied" && !result.capturedInUpdateSet)
+        return 2;
+    return 0;
+}
 /** Parse inline `--fields "k=v, k2=v2"` into a field map. */
 function parseFieldsInline(input) {
     var out = {};
@@ -1388,6 +1510,9 @@ async function main() {
     if (parsed.command === "add-column") {
         return await runAddColumn(parsed.flags);
     }
+    if (parsed.command === "set-column") {
+        return await runSetColumn(parsed.flags, parsed.bare);
+    }
     if (parsed.command === "set-field") {
         return await runSetField(parsed.flags);
     }

package/dist/index.d.ts

@@ -5,10 +5,10 @@
  * REST API so every change lands in the target update set and scope.
  */
 export { createClient } from "./client";
-export { createClientFromEnvFile, resolveConfigFromEnvFile } from "./createClientFromEnvFile";
-export type { ServiceNowClient, TableQueryOptions, TableSchema, TableSchemaField, AttachmentMeta, NowInvokeMethod, NowInvokeParams, NowInvokeResponse } from "./client";
+export { createClientFromEnvFile, resolveConfigFromEnvFile, } from "./createClientFromEnvFile";
+export type { ServiceNowClient, TableQueryOptions, TableSchema, TableSchemaField, AttachmentMeta, NowInvokeMethod, NowInvokeParams, NowInvokeResponse, } from "./client";
 export { addChoicesToField } from "./choices";
-export { hostAssets, classifyChunks, formatHostAssetsResult } from "./hostAssets";
+export { hostAssets, classifyChunks, formatHostAssetsResult, } from "./hostAssets";
 export { formatAddChoicesResult } from "./formatter";
 export { createView } from "./layout/views";
 export { setListLayout } from "./layout/listLayout";
@@ -16,14 +16,14 @@ export { setFormLayout } from "./layout/formLayout";
 export { setRelatedLists } from "./layout/relatedLists";
 export { formatLayoutResult, formatCreateViewResult } from "./layout/formatter";
 export { sincPlugin } from "./plugin";
-export { listTemplates, verifyArtifact, cloneSubflow, cloneActionType, triggerPublication, publishActionType, editActionType, applyStepOps, verifySteps, summarizeSteps, formatStepPill, 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, StepOps, StepRecord, StepSummary, StepIoSummary, PatchStepScriptOp, AddStepOutputOp, AddStepInputOp, ApplyStepOpsResult, VerifyStepsResult, 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, ChunkRole, ChunkInfo, ChunkResult, PrunedResult, HostAssetsParams, HostAssetsResult } from "./types";
-export { createTable, projectTableGraph, buildColumnXml, normalizeColumns, resolveType, applyTableSaveOverlay, defaultAccessFlags, TYPE_MAP, DEFAULT_SUPER_CLASS, DEFAULT_SAVE_ACTION, addColumn, deriveElement } from "./table";
-export type { CreateTableParams, CreateTableResult, AddColumnParams, AddColumnResult, TableGraph, NormalizedColumn, ColumnSpec, AccessFlags, OverlaySpec } from "./table";
+export { listTemplates, verifyArtifact, cloneSubflow, cloneActionType, triggerPublication, publishActionType, editActionType, applyStepOps, verifySteps, summarizeSteps, formatStepPill, 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, StepOps, StepRecord, StepSummary, StepIoSummary, PatchStepScriptOp, AddStepOutputOp, AddStepInputOp, ApplyStepOpsResult, VerifyStepsResult, 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, ChunkRole, ChunkInfo, ChunkResult, PrunedResult, HostAssetsParams, HostAssetsResult, } from "./types";
+export { createTable, projectTableGraph, buildColumnXml, normalizeColumns, resolveType, applyTableSaveOverlay, defaultAccessFlags, TYPE_MAP, DEFAULT_SUPER_CLASS, DEFAULT_SAVE_ACTION, addColumn, deriveElement, setColumn, resolveAttributes, toStoredValue, } from "./table";
+export type { CreateTableParams, CreateTableResult, AddColumnParams, AddColumnResult, SetColumnParams, SetColumnResult, ColumnAttributes, AttributeChange, TableGraph, NormalizedColumn, ColumnSpec, AccessFlags, OverlaySpec, } from "./table";
 export { setField } from "./setField";
 export { createRecord } from "./createRecord";
-export type { RecordWriteResult, SetFieldParams, SetFieldResult } from "./setField";
+export type { RecordWriteResult, SetFieldParams, SetFieldResult, } from "./setField";
 export type { CreateRecordParams, CreateRecordResult } from "./createRecord";
 export { invokeRest, INVOKE_REST_METHODS } from "./invokeRest";
 export type { InvokeRestParams, InvokeRestResult } from "./invokeRest";

package/dist/index.js

@@ -7,7 +7,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addColumn = 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.formatStepPill = exports.summarizeSteps = exports.verifySteps = exports.applyStepOps = 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.formatHostAssetsResult = exports.classifyChunks = exports.hostAssets = exports.addChoicesToField = exports.resolveConfigFromEnvFile = exports.createClientFromEnvFile = exports.createClient = void 0;
-exports.INVOKE_REST_METHODS = exports.invokeRest = exports.createRecord = exports.setField = exports.deriveElement = void 0;
+exports.INVOKE_REST_METHODS = exports.invokeRest = exports.createRecord = exports.setField = exports.toStoredValue = exports.resolveAttributes = exports.setColumn = exports.deriveElement = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return client_1.createClient; } });
 var createClientFromEnvFile_1 = require("./createClientFromEnvFile");
@@ -72,6 +72,9 @@ Object.defineProperty(exports, "DEFAULT_SUPER_CLASS", { enumerable: true, get: f
 Object.defineProperty(exports, "DEFAULT_SAVE_ACTION", { enumerable: true, get: function () { return table_1.DEFAULT_SAVE_ACTION; } });
 Object.defineProperty(exports, "addColumn", { enumerable: true, get: function () { return table_1.addColumn; } });
 Object.defineProperty(exports, "deriveElement", { enumerable: true, get: function () { return table_1.deriveElement; } });
+Object.defineProperty(exports, "setColumn", { enumerable: true, get: function () { return table_1.setColumn; } });
+Object.defineProperty(exports, "resolveAttributes", { enumerable: true, get: function () { return table_1.resolveAttributes; } });
+Object.defineProperty(exports, "toStoredValue", { enumerable: true, get: function () { return table_1.toStoredValue; } });
 var setField_1 = require("./setField");
 Object.defineProperty(exports, "setField", { enumerable: true, get: function () { return setField_1.setField; } });
 var createRecord_1 = require("./createRecord");

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", "action_edit", "flow_publish", "flow_copy", "flow_create", "flow_test", "flow_edit", "create_table", "add_column", "set_field", "create_record", "host_assets", "invoke_rest"];
+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", "action_edit", "flow_publish", "flow_copy", "flow_create", "flow_test", "flow_edit", "create_table", "add_column", "set_column", "set_field", "create_record", "host_assets", "invoke_rest"];
 export type ToolName = (typeof TOOL_NAMES)[number];
 export interface RegistryDeps {
     /** Optional client injection for tests; defaults to createClient({}). */

package/dist/mcp/registry.js

@@ -48,6 +48,7 @@ exports.TOOL_NAMES = [
     "flow_edit",
     "create_table",
     "add_column",
+    "set_column",
     "set_field",
     "create_record",
     "host_assets",
@@ -150,15 +151,15 @@ function buildDescriptors(deps = {}) {
         {
             name: "action_edit",
             annotations: dovetail_mcp_kit_1.WRITE_OVERWRITE,
-            description: "Structurally edit a published Custom Action Type and republish it as one snapshot. "
-                + "Ops: patchStepScripts (per-step script edits, step addressed by cid or label), "
-                + "addStepOutputs (step-level extended_outputs), addStepInputs (step-level extended_inputs "
-                + "wired to another step's output via pillFrom {step, output} — the pill format and the "
-                + "entry shape are handled for you). Also supports the action-level patchScript / setScript / "
-                + "mergeOutputs. DRY-RUN BY DEFAULT: without apply:true it returns the per-step before/after "
-                + "diff and writes nothing. With apply:true it POSTs /snapshot, captures into updateSetSysId "
-                + "when given, then reads the steps back and verifies the edit actually landed. "
-                + "sysId is the sys_hub_action_type_definition sys_id; scopeSysId is the app scope.",
+            description: "Structurally edit a published Custom Action Type and republish it as one snapshot. " +
+                "Ops: patchStepScripts (per-step script edits, step addressed by cid or label), " +
+                "addStepOutputs (step-level extended_outputs), addStepInputs (step-level extended_inputs " +
+                "wired to another step's output via pillFrom {step, output} — the pill format and the " +
+                "entry shape are handled for you). Also supports the action-level patchScript / setScript / " +
+                "mergeOutputs. DRY-RUN BY DEFAULT: without apply:true it returns the per-step before/after " +
+                "diff and writes nothing. With apply:true it POSTs /snapshot, captures into updateSetSysId " +
+                "when given, then reads the steps back and verifies the edit actually landed. " +
+                "sysId is the sys_hub_action_type_definition sys_id; scopeSysId is the app scope.",
             shape: schemas_1.editActionSchema.shape,
             handler: async function (args) {
                 var p = schemas_1.editActionSchema.parse(args);
@@ -168,9 +169,9 @@ function buildDescriptors(deps = {}) {
                     scopeSysId: p.scopeSysId,
                     ops: p.ops,
                     apply: p.apply === true,
-                    updateSetSysId: p.updateSetSysId
+                    updateSetSysId: p.updateSetSysId,
                 });
-            }
+            },
         },
         {
             name: "flow_publish",
@@ -349,6 +350,47 @@ function buildDescriptors(deps = {}) {
                 });
             },
         },
+        {
+            name: "set_column",
+            annotations: dovetail_mcp_kit_1.WRITE_OVERWRITE,
+            description: "Update the SCHEMA of an EXISTING column on an EXISTING ServiceNow table — its label, " +
+                "mandatory, default, readOnly, or maxLength — captured into a named update set, then READ " +
+                "BACK from the instance to verify. This is the schema counterpart to set_field: set_field " +
+                "changes a RECORD's value, set_column changes the COLUMN's definition (sys_dictionary). Use " +
+                "add_column to CREATE a column. maxLength is PHYSICAL — changing it fires a real ALTER on the " +
+                "table, and that works (verified live). internal_type and element (rename) are REFUSED, not " +
+                "written: ServiceNow returns HTTP 200 and silently ignores both on an existing column, so a " +
+                "write would report success while changing nothing — delete and recreate the column instead. " +
+                "Attributes are a closed set, never an open field map. When every requested value already " +
+                "matches, nothing is written and the status is 'unchanged' (an ALTER fires on a CHANGE, not a " +
+                "write). A maxLength SHRINK is REFUSED while rows hold longer values: ServiceNow silently " +
+                "refuses such a shrink (200 OK, column unchanged, data preserved), so the tool names the " +
+                "blocking rows instead of issuing a write that would be quietly ignored. Clear those values " +
+                "first, then re-run — there is no override, because forcing it would either do nothing or " +
+                "destroy data. dryRun:true diffs against the instance, flags the blocking rows, and writes nothing.",
+            shape: schemas_1.setColumnSchema.shape,
+            handler: async function (args) {
+                var p = schemas_1.setColumnSchema.parse(args);
+                // The schema leaves updateSetSysId optional (dry-run doesn't need one), so
+                // enforce the live-path requirement HERE — a tool-level error before any
+                // work beats a failure surfacing from deep inside setColumn. Same pattern
+                // as add_column.
+                if (p.dryRun !== true &&
+                    (!p.updateSetSysId || !p.updateSetSysId.trim())) {
+                    throw new Error("set_column: updateSetSysId is required on the live path so the schema " +
+                        "change is captured in a known update set — set dryRun:true to plan " +
+                        "without one.");
+                }
+                return (0, table_1.setColumn)({
+                    client: client(),
+                    table: p.table,
+                    column: p.column,
+                    attributes: p.attributes,
+                    updateSetSysId: p.updateSetSysId,
+                    dryRun: p.dryRun,
+                });
+            },
+        },
         {
             name: "set_field",
             annotations: dovetail_mcp_kit_1.WRITE_OVERWRITE,

package/dist/mcp/schemas.d.ts

@@ -830,6 +830,90 @@ export declare var addColumnSchema: z.ZodObject<{
     scope?: string | undefined;
     updateSetSysId?: string | undefined;
 }>;
+export declare var columnAttributesSchema: z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    mandatory: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodString>;
+    readOnly: z.ZodOptional<z.ZodBoolean>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    internalType: z.ZodOptional<z.ZodString>;
+    element: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    default?: string | undefined;
+    label?: string | undefined;
+    element?: string | undefined;
+    readOnly?: boolean | undefined;
+    maxLength?: number | undefined;
+    mandatory?: boolean | undefined;
+    internalType?: string | undefined;
+}, {
+    default?: string | undefined;
+    label?: string | undefined;
+    element?: string | undefined;
+    readOnly?: boolean | undefined;
+    maxLength?: number | undefined;
+    mandatory?: boolean | undefined;
+    internalType?: string | undefined;
+}>;
+export declare var setColumnSchema: z.ZodObject<{
+    table: z.ZodString;
+    column: z.ZodString;
+    attributes: z.ZodObject<{
+        label: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodString>;
+        readOnly: z.ZodOptional<z.ZodBoolean>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        internalType: z.ZodOptional<z.ZodString>;
+        element: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        default?: string | undefined;
+        label?: string | undefined;
+        element?: string | undefined;
+        readOnly?: boolean | undefined;
+        maxLength?: number | undefined;
+        mandatory?: boolean | undefined;
+        internalType?: string | undefined;
+    }, {
+        default?: string | undefined;
+        label?: string | undefined;
+        element?: string | undefined;
+        readOnly?: boolean | undefined;
+        maxLength?: number | undefined;
+        mandatory?: boolean | undefined;
+        internalType?: string | undefined;
+    }>;
+    updateSetSysId: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    table: string;
+    attributes: {
+        default?: string | undefined;
+        label?: string | undefined;
+        element?: string | undefined;
+        readOnly?: boolean | undefined;
+        maxLength?: number | undefined;
+        mandatory?: boolean | undefined;
+        internalType?: string | undefined;
+    };
+    column: string;
+    dryRun?: boolean | undefined;
+    updateSetSysId?: string | undefined;
+}, {
+    table: string;
+    attributes: {
+        default?: string | undefined;
+        label?: string | undefined;
+        element?: string | undefined;
+        readOnly?: boolean | undefined;
+        maxLength?: number | undefined;
+        mandatory?: boolean | undefined;
+        internalType?: string | undefined;
+    };
+    column: string;
+    dryRun?: boolean | undefined;
+    updateSetSysId?: string | undefined;
+}>;
 export declare var setFieldSchema: z.ZodObject<{
     table: z.ZodString;
     sysId: z.ZodOptional<z.ZodString>;