@tenonhq/dovetail-servicenow 0.0.21 → 0.0.23

package/dist/mcp/registry.js

@@ -26,6 +26,7 @@ const createFlow_1 = require("../flowDesigner/createFlow");
 const editFlow_1 = require("../flowDesigner/editFlow");
 const testFlow_1 = require("../flowDesigner/testFlow");
 const table_1 = require("../table");
+const hostAssets_1 = require("../hostAssets");
 const schemas_1 = require("./schemas");
 exports.TOOL_NAMES = [
     "create_view",
@@ -40,7 +41,9 @@ exports.TOOL_NAMES = [
     "flow_create",
     "flow_test",
     "flow_edit",
-    "create_table"
+    "create_table",
+    "add_column",
+    "host_assets"
 ];
 // Annotation presets (READ_ONLY / WRITE_ADDITIVE_IDEMPOTENT / WRITE_CREATE /
 // WRITE_OVERWRITE / WRITE_EXECUTE) come from @tenonhq/dovetail-mcp-kit.
@@ -263,6 +266,53 @@ function buildDescriptors(deps = {}) {
                     dryRun: p.dryRun
                 });
             }
+        },
+        {
+            name: "add_column",
+            annotations: dovetail_mcp_kit_1.WRITE_CREATE,
+            description: "Add ONE column to an EXISTING ServiceNow table, headless and faithfully. Creating a column is a "
+                + "sys_dictionary insert; a REST/createRecord insert reliably 500s for a scoped-app column. This "
+                + "replays the Studio table-form save (POST /sys_db_object.do) against the existing table record, "
+                + "embedding the new column as list-edit XML, then READS THE COLUMN BACK from sys_dictionary to prove "
+                + "it landed (a 302 that did not create the field is reported failed, not created). table is the table "
+                + "name or its sys_db_object sys_id; column is { label, type, name?, max_length?, reference? } with "
+                + "friendly types mapped to internal types (string -> string_full_utf8); element is derived from label "
+                + "unless column.name is given. dryRun:true returns the plan + column XML 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.addColumnSchema.shape,
+            handler: async function (args) {
+                var p = schemas_1.addColumnSchema.parse(args);
+                return (0, table_1.addColumn)({
+                    client: client(),
+                    table: p.table,
+                    column: p.column,
+                    scope: p.scope,
+                    updateSetSysId: p.updateSetSysId,
+                    saveActionSysId: p.saveActionSysId,
+                    columnsRelId: p.columnsRelId,
+                    dryRun: p.dryRun,
+                    debug: p.debug
+                });
+            }
+        },
+        {
+            name: "host_assets",
+            annotations: dovetail_mcp_kit_1.WRITE_OVERWRITE,
+            description: "Deploy a pre-built front-end dist/ bundle to ServiceNow. For each chunk (index.html + "
+                + "assets/*.{js,css}) upserts a carrier sys_ui_script named app_shell_asset:<vite-relative-path> "
+                + "(the rotating hash is part of the name on purpose — the Scripted REST serving resource resolves "
+                + "an asset by this exact name), stores the chunk bytes as a sys_attachment (the script field caps "
+                + "at 65 KB), and wires an x_cadso_app_shell_m2m_app_script row (application, script, chunk_role, "
+                + "order). PRUNES carriers + m2m rows for chunks no longer in the build (hashes rotate per build). "
+                + "Idempotent — identical bytes (by SHA-256) are left in place. Fails fast on any chunk at/over the "
+                + "~5 MB serve cap (glide.scriptable.excel.max_file_size) unless allowOversize. app is the application "
+                + "record sys_id; dir is a local dist path on the server running this tool; script + m2m writes are "
+                + "captured in the update set; dryRun previews without writing.",
+            shape: schemas_1.hostAssetsSchema.shape,
+            handler: async function (args) {
+                return (0, hostAssets_1.hostAssets)(client(), schemas_1.hostAssetsSchema.parse(args));
+            }
         }
     ];
 }

package/dist/mcp/schemas.d.ts

@@ -382,6 +382,31 @@ export declare var editFlowSchema: z.ZodObject<{
     updateSetSysId?: string | undefined;
     apply?: boolean | undefined;
 }>;
+export declare var hostAssetsSchema: z.ZodObject<{
+    dir: z.ZodString;
+    app: z.ZodString;
+    scope: z.ZodString;
+    updateSetSysId: z.ZodOptional<z.ZodString>;
+    maxBytes: z.ZodOptional<z.ZodNumber>;
+    allowOversize: z.ZodOptional<z.ZodBoolean>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    dir: string;
+    scope: string;
+    app: string;
+    dryRun?: boolean | undefined;
+    updateSetSysId?: string | undefined;
+    maxBytes?: number | undefined;
+    allowOversize?: boolean | undefined;
+}, {
+    dir: string;
+    scope: string;
+    app: string;
+    dryRun?: boolean | undefined;
+    updateSetSysId?: string | undefined;
+    maxBytes?: number | undefined;
+    allowOversize?: boolean | undefined;
+}>;
 export declare var columnSpecSchema: z.ZodObject<{
     label: z.ZodString;
     type: z.ZodString;
@@ -480,3 +505,61 @@ export declare var createTableSchema: z.ZodObject<{
     saveActionSysId?: string | undefined;
     columnsRelId?: string | undefined;
 }>;
+export declare var addColumnSchema: z.ZodObject<{
+    table: z.ZodString;
+    column: 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;
+    }>;
+    scope: z.ZodOptional<z.ZodString>;
+    updateSetSysId: z.ZodOptional<z.ZodString>;
+    saveActionSysId: z.ZodOptional<z.ZodString>;
+    columnsRelId: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    table: string;
+    column: {
+        type: string;
+        label: string;
+        name?: string | undefined;
+        max_length?: string | number | undefined;
+        reference?: string | undefined;
+    };
+    dryRun?: boolean | undefined;
+    debug?: boolean | undefined;
+    scope?: string | undefined;
+    updateSetSysId?: string | undefined;
+    saveActionSysId?: string | undefined;
+    columnsRelId?: string | undefined;
+}, {
+    table: string;
+    column: {
+        type: string;
+        label: string;
+        name?: string | undefined;
+        max_length?: string | number | undefined;
+        reference?: string | undefined;
+    };
+    dryRun?: boolean | undefined;
+    debug?: boolean | undefined;
+    scope?: string | undefined;
+    updateSetSysId?: string | undefined;
+    saveActionSysId?: string | undefined;
+    columnsRelId?: 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.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;
+exports.addColumnSchema = exports.createTableSchema = exports.columnSpecSchema = exports.hostAssetsSchema = 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,6 +113,15 @@ exports.editFlowSchema = zod_1.z.object({
     scopeSysId: zod_1.z.string().optional(),
     updateSetSysId: zod_1.z.string().optional()
 });
+exports.hostAssetsSchema = zod_1.z.object({
+    dir: zod_1.z.string().min(1),
+    app: zod_1.z.string().min(1),
+    scope: zod_1.z.string().min(1),
+    updateSetSysId: zod_1.z.string().min(1).optional(),
+    maxBytes: zod_1.z.number().int().positive().optional(),
+    allowOversize: zod_1.z.boolean().optional(),
+    dryRun: zod_1.z.boolean().optional()
+});
 exports.columnSpecSchema = zod_1.z.object({
     label: zod_1.z.string().min(1),
     type: zod_1.z.string().min(1),
@@ -137,3 +146,13 @@ exports.createTableSchema = zod_1.z.object({
     dryRun: zod_1.z.boolean().optional(),
     debug: zod_1.z.boolean().optional()
 });
+exports.addColumnSchema = zod_1.z.object({
+    table: zod_1.z.string().min(1),
+    column: exports.columnSpecSchema,
+    scope: zod_1.z.string().optional(),
+    updateSetSysId: zod_1.z.string().optional(),
+    saveActionSysId: zod_1.z.string().optional(),
+    columnsRelId: zod_1.z.string().optional(),
+    dryRun: zod_1.z.boolean().optional(),
+    debug: zod_1.z.boolean().optional()
+});

package/dist/table/addColumn.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Add ONE column to an EXISTING ServiceNow table — headless, the faithful way.
+ * Creating a column is inserting a `sys_dictionary` record; a REST / Dovetail
+ * createRecord insert into sys_dictionary reliably 500s for a scoped-app column
+ * (scope-policy + the dictionary engine being wired to the form transaction, not
+ * the REST insert). The faithful path is the one the Studio UI drives: a single
+ * `POST /sys_db_object.do` against the EXISTING table record whose body embeds the
+ * new column as the same list-edit XML blob create-table uses.
+ *
+ * This REUSES the create-table machinery wholesale (buildColumnXml, formSession,
+ * the list-edit key + type normalization) and differs in exactly two ways:
+ *   1. It GETs the EXISTING table form (sys_id=<tableSysId>), which renders the
+ *      "Columns" related list — so the real listEditKey is harvested, not faked.
+ *   2. It overlays ONLY the column XML + the save machinery, preserving every
+ *      existing table field from the harvest (name/label/scope/ACLs untouched).
+ * Then it READS THE COLUMN BACK from sys_dictionary to prove it landed — a write
+ * that 302s but didn't create the field is reported as failed, never "created".
+ *
+ * Validated live 2026-06-19 on tenonworkstudio (a smoke-test scoped table): the
+ * form save creates the column (HTTP 200 re-render, not a 302), the before/after
+ * sys_dictionary diff confirms it, and a scoped insert into the new column
+ * round-trips — proving the physical column, not just the dictionary row. ES6
+ * only, no optional chaining, no `any`.
+ */
+import type { ServiceNowClient } from "../client";
+import { ColumnSpec } from "./buildTableSave";
+export interface AddColumnParams {
+    /** REST client for table/scope resolution + the read-back verify. */
+    client: ServiceNowClient;
+    /** Existing table — its name ("x_cadso_journey") OR its sys_db_object sys_id. */
+    table: string;
+    /** The single column to add. `name` (the element) is optional; derived from label when omitted. */
+    column: ColumnSpec;
+    /** Scope name or sys_scope sys_id to run the form session in. Defaults to the table's own scope. */
+    scope?: string;
+    /** Update set sys_id to pin the writes to. Strongly recommended. */
+    updateSetSysId?: string;
+    /** Override the Save UI-action sys_id (defaults to the well-known global Save). */
+    saveActionSysId?: string;
+    /** Override the "Table Columns" relationship sys_id (fallback only — the existing form normally yields it). */
+    columnsRelId?: string;
+    /** Emit diagnostic detail in the result note. */
+    debug?: boolean;
+    /** Instance/creds for the form session (default: env, same precedence as the client). */
+    instance?: string;
+    user?: string;
+    password?: string;
+    /** Plan only — no session, no writes. Pure + deterministic. */
+    dryRun?: boolean;
+}
+export interface AddColumnResult {
+    status: "created" | "dry-run" | "failed";
+    /** The table's name (resolved; echoes the input on dry-run). */
+    table: string;
+    /** sys_db_object sys_id ("" on dry-run / when unresolved). */
+    tableSysId: string;
+    /** The dictionary element (column name) — derived from label or the explicit `name`. */
+    element: string;
+    /** The column's display label. */
+    label: string;
+    /** Resolved ServiceNow internal_type (friendly -> internal). */
+    internalType: string;
+    /** Client-generated sys_id sent for the new sys_dictionary row. */
+    columnSysId: string;
+    /** Update set the write was pinned to ("" if none). */
+    updateSetSysId: string;
+    httpStatus: number;
+    /** 302 Location on a successful POST. */
+    location: string;
+    /** The embedded column XML (always populated — it is pure). */
+    columnXml: string;
+    /** True only when the column was READ BACK from sys_dictionary after the POST. */
+    verified: boolean;
+    /** Human-readable note (success summary, the read-back result, or the failure body). */
+    note: string;
+}
+/**
+ * Derive the dictionary element (column name) from a label the way Studio does for
+ * a scoped table: lower-case, every run of non-alphanumerics -> a single
+ * underscore, trimmed. Scoped custom columns are NOT u_-prefixed (that is a
+ * global-scope-on-OOB-table behaviour), so "URL" -> "url". Pass `column.name`
+ * explicitly for anything non-trivial.
+ */
+export declare function deriveElement(label: string, explicit?: string): string;
+/**
+ * Overlay ONLY the new-column list-edit XML and the form-save machinery onto the
+ * fields harvested from the EXISTING table form. Returns a NEW object; every
+ * existing table field (name, label, scope, access, super_class, …) is preserved
+ * from `base` untouched — an add-column must not re-stamp the table. Mirrors the
+ * harvested-defaults-preserved contract of applyTableSaveOverlay.
+ */
+export declare function applyAddColumnOverlay(base: Record<string, string>, o: {
+    tableSysId: string;
+    saveActionSysId: string;
+    listEditKey: string;
+    columnXml: string;
+}): Record<string, string>;
+export declare function addColumn(params: AddColumnParams): Promise<AddColumnResult>;