@salesforce/graphiti 10.15.1 → 10.16.0

package/src/mcp/tools/sf-gql-detail.ts

@@ -5,55 +5,15 @@
  */
 
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import {
-	childRelationshipSchema,
-	graphqlName,
-	orderByObject,
-	orgAlias,
-} from "./shared/zod-schemas.js";
 import { buildDetail } from "../../intent/build-detail.js";
 import { type PrimeDeps } from "../../lib/prime-schema.js";
+import { DETAIL_INPUT } from "../../schemas/input-schemas.js";
 
 export interface SfGqlDetailToolOptions {
 	primeDeps?: PrimeDeps;
 }
 
-// Advertised schema per FR-6.3 is the singleton object form; we still accept
-// arrays at runtime via `z.preprocess` (FR-6.2 compat shim for early MCP
-// clients that learned the array shape). The transform collapses to the first
-// element before validation, so downstream code sees a singleton.
-const orderBySchema = z.preprocess((v) => (Array.isArray(v) ? v[0] : v), orderByObject);
-
-// Note: filter/orderBy/scope/first are intentionally absent at the top level —
-// `sf_gql_detail` is single-record-by-Id (FR-5.5). Filtering happens via the
-// declared `$<idVariable>: ID!`; pagination doesn't apply.
-//
-// `.strict()` rejects unknown top-level keys at the MCP boundary so an LLM
-// hallucinating sibling-tool params (`filter`, `scope`, `first`) gets a
-// validation error to learn from rather than silent omission.
-const inputSchema = z
-	.object({
-		org: orgAlias("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
-		object: graphqlName('SObject API name, e.g. "Account", "Case". Must be a valid GraphQL Name.'),
-		fields: z
-			.array(z.string())
-			.describe(
-				'Scalar field API names to select on the node. Dot-paths like "Owner.Name" are allowed.',
-			),
-		parentFields: z
-			.array(z.string())
-			.optional()
-			.describe('Dotted parent-relationship paths, e.g. "Account.Name".'),
-		childRelationships: z.array(childRelationshipSchema(orderBySchema)).optional(),
-		idVariable: graphqlName(
-			'Name (without leading "$") for the ID variable. Defaults to "id". Declared as <name>: ID! and bound via where { Id: { eq: $<name> } } per FR-5.5. Choose a name that does not appear as a $varName in any childRelationships filter/orderBy — collisions are rejected.',
-		).optional(),
-		operationName: graphqlName(
-			"Override the GraphQL operation name. Defaults to <Object>Detail.",
-		).optional(),
-	})
-	.strict();
+const inputSchema = DETAIL_INPUT;
 
 export function registerSfGqlDetailTool(
 	server: McpServer,

package/src/mcp/tools/sf-gql-discover.ts

@@ -5,46 +5,12 @@
  */
 
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
 import { buildDiscover, type DiscoverDeps } from "../../intent/build-discover.js";
+import { DISCOVER_INPUT } from "../../schemas/input-schemas.js";
 
 export type SfGqlDiscoverToolOptions = DiscoverDeps;
 
-// Org/object/field flow into shell commands (sf CLI), filesystem paths
-// (ObjectInfo cache), and GraphQL operation names. Bound at the MCP boundary
-// to safe API-name charsets so downstream layers can trust them.
-const ORG_ALIAS_RE = /^[A-Za-z0-9_-]{1,80}$/;
-const SOBJECT_NAME_RE = /^[A-Za-z][A-Za-z0-9_]{0,79}$/;
-// eslint-disable-next-line no-control-regex -- intentionally rejects control chars
-const SEARCH_RE = /^[^\x00-\x1f\x7f]*$/;
-
-const inputSchema = {
-	org: z
-		.string()
-		.regex(ORG_ALIAS_RE, "org must match /^[A-Za-z0-9_-]{1,80}$/")
-		.describe("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
-	mode: z
-		.enum(["list_objects", "describe_object", "describe_field"])
-		.describe(
-			'Discovery mode. "list_objects" enumerates queryable SObjects; "describe_object" and "describe_field" return ObjectInfo metadata.',
-		),
-	object: z
-		.string()
-		.regex(SOBJECT_NAME_RE, "object must match /^[A-Za-z][A-Za-z0-9_]{0,79}$/")
-		.optional()
-		.describe('SObject API name. Required for "describe_object" and "describe_field".'),
-	field: z
-		.string()
-		.regex(SOBJECT_NAME_RE, "field must match /^[A-Za-z][A-Za-z0-9_]{0,79}$/")
-		.optional()
-		.describe('Field API name. Required for "describe_field".'),
-	search: z
-		.string()
-		.max(100, "search must be 100 characters or fewer")
-		.regex(SEARCH_RE, "search must not contain control characters")
-		.optional()
-		.describe('Optional substring filter applied to "list_objects" results.'),
-};
+const inputSchema = DISCOVER_INPUT.shape;
 
 export function registerSfGqlDiscoverTool(
 	server: McpServer,

package/src/mcp/tools/sf-gql-list.ts

@@ -5,54 +5,15 @@
  */
 
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { childRelationshipSchema, graphqlName, orderByObject } from "./shared/zod-schemas.js";
 import { buildList } from "../../intent/build-list.js";
 import { type PrimeDeps } from "../../lib/prime-schema.js";
+import { LIST_INPUT } from "../../schemas/input-schemas.js";
 
 export interface SfGqlListToolOptions {
 	primeDeps?: PrimeDeps;
 }
 
-// `sf_gql_list` advertises both shapes (singleton + array) for backward
-// compatibility with early MCP clients that learned the array form.
-const orderBySchema = z.union([orderByObject, z.array(orderByObject)]);
-
-const inputSchema = {
-	org: z.string().describe("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
-	object: graphqlName('SObject API name, e.g. "Account", "Case". Must be a valid GraphQL Name.'),
-	fields: z
-		.array(z.string())
-		.describe(
-			'Scalar field API names to select on the node. Dot-paths like "Owner.Name" are allowed.',
-		),
-	parentFields: z
-		.array(z.string())
-		.optional()
-		.describe('Dotted parent-relationship paths, e.g. "Account.Name".'),
-	childRelationships: z.array(childRelationshipSchema(orderBySchema)).optional(),
-	filter: z
-		.record(z.unknown())
-		.optional()
-		.describe(
-			"<Object>_Filter shape. String leaves matching $varName promote to typed query variables.",
-		),
-	orderBy: orderBySchema
-		.optional()
-		.describe(
-			"<Object>_OrderBy. Singleton object preferred; arrays are collapsed to the first entry.",
-		),
-	first: z
-		.number()
-		.int()
-		.positive()
-		.optional()
-		.describe("Top-level connection page size; defaults to 10."),
-	scope: z.string().optional().describe('Scope enum (e.g. "MINE", "EVERYTHING") or $varName.'),
-	operationName: graphqlName(
-		"Override the GraphQL operation name. Defaults to <Object>List.",
-	).optional(),
-};
+const inputSchema = LIST_INPUT.shape;
 
 export function registerSfGqlListTool(server: McpServer, opts: SfGqlListToolOptions = {}): void {
 	server.registerTool(

package/src/mcp/tools/sf-gql-raw.ts

@@ -5,38 +5,15 @@
  */
 
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { graphqlName } from "./shared/zod-schemas.js";
 import { buildRaw } from "../../intent/build-raw.js";
 import { type PrimeDeps } from "../../lib/prime-schema.js";
+import { RAW_INPUT } from "../../schemas/input-schemas.js";
 
 export interface SfGqlRawToolOptions {
 	primeDeps?: PrimeDeps;
 }
 
-const inputSchema = {
-	org: z.string().describe("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
-	commands: z
-		.array(z.string())
-		.min(1)
-		.describe(
-			"CLI-style commands applied in order to a transient session. Supported verbs:\n" +
-				"  select <path[:alias]>      e.g. select uiapi/query/Case/edges/node/Subject/value\n" +
-				"  set [<path>] <key>=<value> e.g. set uiapi/query/Case first=10  |  set uiapi/query/Case where.Status=New\n" +
-				"  var $name <path> [default] e.g. var $id uiapi/query/Case/@args/where/Id/eq (type inferred from path)\n" +
-				'Each command is tokenized on spaces and a value MUST NOT contain a space — quoting does not help once a token has started (key=\'a b\' still splits). A filter value that contains a space (e.g. "New York", "In Progress") cannot be expressed via set in v1; use sf_gql_list with a JSON filter, or pass the value through a variable bound with var.\n' +
-				"Fails fast: a bad command aborts the whole call. Other CLI verbs (cd, drop, alias, optional, unset) are NOT supported in v1.",
-		),
-	operation: z
-		.enum(["query", "mutation", "aggregate"])
-		.optional()
-		.describe(
-			'Operation root. "query" (default) → uiapi.query; "mutation" → mutation root; "aggregate" → uiapi.aggregate.',
-		),
-	typeName: graphqlName(
-		"Override the GraphQL operation name. Defaults to Raw<Operation>.",
-	).optional(),
-};
+const inputSchema = RAW_INPUT.shape;
 
 export function registerSfGqlRawTool(server: McpServer, opts: SfGqlRawToolOptions = {}): void {
 	server.registerTool(

package/src/mcp/tools/sf-gql-update.ts

@@ -5,34 +5,15 @@
  */
 
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { graphqlName } from "./shared/zod-schemas.js";
 import { buildUpdate } from "../../intent/build-update.js";
 import { type PrimeDeps } from "../../lib/prime-schema.js";
+import { UPDATE_INPUT } from "../../schemas/input-schemas.js";
 
 export interface SfGqlUpdateToolOptions {
 	primeDeps?: PrimeDeps;
 }
 
-const inputSchema = {
-	org: z.string().describe("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
-	object: graphqlName('SObject API name, e.g. "Account", "Order". Must be a valid GraphQL Name.'),
-	returnFields: z
-		.array(z.string())
-		.optional()
-		.describe(
-			'Scalar field API names to read back on the updated Record. Defaults to ["Id"]. Dot-paths like Owner.Name are not supported in mutation results; passing them produces a warning and the field is skipped.',
-		),
-	inputVariable: z
-		.string()
-		.optional()
-		.describe(
-			'Variable name (without "$") for the update input. Defaults to "input". Declared as $<name>: <Object>UpdateInput!.',
-		),
-	operationName: graphqlName(
-		"Override the GraphQL operation name. Defaults to Update<Object>.",
-	).optional(),
-};
+const inputSchema = UPDATE_INPUT.shape;
 
 export function registerSfGqlUpdateTool(
 	server: McpServer,

package/src/{mcp/tools/shared/zod-schemas.ts → schemas/fields.ts}

@@ -5,7 +5,7 @@
  */
 
 import { z } from "zod";
-import { GRAPHQL_NAME_RE } from "../../../lib/graphql-name.js";
+import { GRAPHQL_NAME_RE } from "../lib/graphql-name.js";
 
 /**
  * Zod string validator that enforces the GraphQL Name production. Returned

package/src/schemas/input-schemas.ts

@@ -0,0 +1,305 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/**
+ * Per-tool Zod input schemas, extracted so the MCP server and the CLI mirror
+ * (`src/commands/mcp-mirror/`) validate identical argument shapes. The MCP
+ * tools consume `<TOOL>_INPUT.shape` (raw-shape registration) or the object
+ * directly (`detail`, which is `.strict()`); the CLI adapters call
+ * `<TOOL>_INPUT.parse()` on the incoming JSON. Single source of truth keeps
+ * the two transports arg-for-arg symmetric.
+ *
+ * Descriptions and validation are preserved verbatim from the original inline
+ * schemas; behavior is unchanged — this is a pure extraction.
+ */
+
+import { z } from "zod";
+import { childRelationshipSchema, graphqlName, orderByObject, orgAlias } from "./fields.js";
+import { GROUP_BY_FUNCTIONS } from "../intent/types.js";
+
+// --- sf_gql_list ------------------------------------------------------------
+
+// `sf_gql_list` advertises both shapes (singleton + array) for backward
+// compatibility with early MCP clients that learned the array form.
+const listOrderBySchema = z.union([orderByObject, z.array(orderByObject)]);
+
+export const LIST_INPUT = z.object({
+	org: z.string().describe("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
+	object: graphqlName('SObject API name, e.g. "Account", "Case". Must be a valid GraphQL Name.'),
+	fields: z
+		.array(z.string())
+		.describe(
+			'Scalar field API names to select on the node. Dot-paths like "Owner.Name" are allowed.',
+		),
+	parentFields: z
+		.array(z.string())
+		.optional()
+		.describe('Dotted parent-relationship paths, e.g. "Account.Name".'),
+	childRelationships: z.array(childRelationshipSchema(listOrderBySchema)).optional(),
+	filter: z
+		.record(z.unknown())
+		.optional()
+		.describe(
+			"<Object>_Filter shape. String leaves matching $varName promote to typed query variables.",
+		),
+	orderBy: listOrderBySchema
+		.optional()
+		.describe(
+			"<Object>_OrderBy. Singleton object preferred; arrays are collapsed to the first entry.",
+		),
+	first: z
+		.number()
+		.int()
+		.positive()
+		.optional()
+		.describe("Top-level connection page size; defaults to 10."),
+	scope: z.string().optional().describe('Scope enum (e.g. "MINE", "EVERYTHING") or $varName.'),
+	operationName: graphqlName(
+		"Override the GraphQL operation name. Defaults to <Object>List.",
+	).optional(),
+});
+
+// --- sf_gql_detail ----------------------------------------------------------
+
+// Advertised schema per FR-6.3 is the singleton object form; we still accept
+// arrays at runtime via `z.preprocess` (FR-6.2 compat shim for early MCP
+// clients that learned the array shape). The transform collapses to the first
+// element before validation, so downstream code sees a singleton.
+const detailOrderBySchema = z.preprocess((v) => (Array.isArray(v) ? v[0] : v), orderByObject);
+
+// Note: filter/orderBy/scope/first are intentionally absent at the top level —
+// `sf_gql_detail` is single-record-by-Id (FR-5.5). Filtering happens via the
+// declared `$<idVariable>: ID!`; pagination doesn't apply.
+//
+// `.strict()` rejects unknown top-level keys at the MCP boundary so an LLM
+// hallucinating sibling-tool params (`filter`, `scope`, `first`) gets a
+// validation error to learn from rather than silent omission.
+export const DETAIL_INPUT = z
+	.object({
+		org: orgAlias("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
+		object: graphqlName('SObject API name, e.g. "Account", "Case". Must be a valid GraphQL Name.'),
+		fields: z
+			.array(z.string())
+			.describe(
+				'Scalar field API names to select on the node. Dot-paths like "Owner.Name" are allowed.',
+			),
+		parentFields: z
+			.array(z.string())
+			.optional()
+			.describe('Dotted parent-relationship paths, e.g. "Account.Name".'),
+		childRelationships: z.array(childRelationshipSchema(detailOrderBySchema)).optional(),
+		idVariable: graphqlName(
+			'Name (without leading "$") for the ID variable. Defaults to "id". Declared as <name>: ID! and bound via where { Id: { eq: $<name> } } per FR-5.5. Choose a name that does not appear as a $varName in any childRelationships filter/orderBy — collisions are rejected.',
+		).optional(),
+		operationName: graphqlName(
+			"Override the GraphQL operation name. Defaults to <Object>Detail.",
+		).optional(),
+	})
+	.strict();
+
+// --- sf_gql_discover --------------------------------------------------------
+
+// Org/object/field flow into shell commands (sf CLI), filesystem paths
+// (ObjectInfo cache), and GraphQL operation names. Bound at the MCP boundary
+// to safe API-name charsets so downstream layers can trust them.
+const DISCOVER_ORG_ALIAS_RE = /^[A-Za-z0-9_-]{1,80}$/;
+const DISCOVER_SOBJECT_NAME_RE = /^[A-Za-z][A-Za-z0-9_]{0,79}$/;
+// eslint-disable-next-line no-control-regex -- intentionally rejects control chars
+const DISCOVER_SEARCH_RE = /^[^\x00-\x1f\x7f]*$/;
+
+export const DISCOVER_INPUT = z.object({
+	org: z
+		.string()
+		.regex(DISCOVER_ORG_ALIAS_RE, "org must match /^[A-Za-z0-9_-]{1,80}$/")
+		.describe("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
+	mode: z
+		.enum(["list_objects", "describe_object", "describe_field"])
+		.describe(
+			'Discovery mode. "list_objects" enumerates queryable SObjects; "describe_object" and "describe_field" return ObjectInfo metadata.',
+		),
+	object: z
+		.string()
+		.regex(DISCOVER_SOBJECT_NAME_RE, "object must match /^[A-Za-z][A-Za-z0-9_]{0,79}$/")
+		.optional()
+		.describe('SObject API name. Required for "describe_object" and "describe_field".'),
+	field: z
+		.string()
+		.regex(DISCOVER_SOBJECT_NAME_RE, "field must match /^[A-Za-z][A-Za-z0-9_]{0,79}$/")
+		.optional()
+		.describe('Field API name. Required for "describe_field".'),
+	search: z
+		.string()
+		.max(100, "search must be 100 characters or fewer")
+		.regex(DISCOVER_SEARCH_RE, "search must not contain control characters")
+		.optional()
+		.describe('Optional substring filter applied to "list_objects" results.'),
+});
+
+// --- sf_gql_aggregate -------------------------------------------------------
+
+const aliasField = z
+	.string()
+	.optional()
+	.describe("GraphQL alias for this aggregation's result key.");
+
+const aggregationSchema = z.discriminatedUnion("function", [
+	z.object({
+		function: z.enum(["count", "countDistinct"]),
+		field: z.string().optional().describe('SObject field API name. Defaults to "Id" when omitted.'),
+		alias: aliasField,
+	}),
+	z.object({
+		function: z.enum(["sum", "avg", "min", "max"]),
+		field: z.string().describe("SObject field API name. Required for sum/avg/min/max."),
+		alias: aliasField,
+	}),
+]);
+
+const groupByElementSchema = z.union([
+	z.string(),
+	z.object({
+		field: z.string().describe("SObject field API name (DateTime/Date field)."),
+		function: z
+			.enum(GROUP_BY_FUNCTIONS)
+			.describe("Date bucketing function from UIAPI GroupByFunction enum."),
+	}),
+]);
+
+export const AGGREGATE_INPUT = z.object({
+	org: z.string().describe("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
+	object: graphqlName('SObject API name, e.g. "Account", "Order". Must be a valid GraphQL Name.'),
+	groupBy: z
+		.array(groupByElementSchema)
+		.optional()
+		.describe(
+			"GroupBy elements. Each is either a plain field name string (renders as `{Field: {group: true}}`) or an object `{field, function}` for date-bucketed groupBy (renders as `{Field: {function: CALENDAR_MONTH}}`). Omit or pass `[]` for un-grouped aggregation; with no aggregations either, defaults to `count` over `Id` (FR-8.2).",
+		),
+	aggregations: z
+		.array(aggregationSchema)
+		.optional()
+		.describe(
+			"List of aggregation functions to compute. Each entry projects under its alias (or default `<function><PascalCaseField>`).",
+		),
+	filter: z
+		.record(z.unknown())
+		.optional()
+		.describe(
+			"<Object>_Filter applied to every aggregation. String leaves matching $varName promote to typed query variables.",
+		),
+	orderBy: z
+		.union([z.record(z.unknown()), z.array(z.record(z.unknown()))])
+		.optional()
+		.describe(
+			"<Object>_OrderBy. Singleton object preferred; arrays are collapsed to the first entry. String leaves matching $varName promote to typed query variables.",
+		),
+	first: z
+		.number()
+		.int()
+		.positive()
+		.optional()
+		.describe("Connection page size (top-N pattern). No default — omit for all buckets."),
+	operationName: graphqlName(
+		"Override the GraphQL operation name. Defaults to <Object>Aggregate.",
+	).optional(),
+});
+
+// --- sf_gql_raw -------------------------------------------------------------
+
+export const RAW_INPUT = z.object({
+	org: z.string().describe("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
+	commands: z
+		.array(z.string())
+		.min(1)
+		.describe(
+			"CLI-style commands applied in order to a transient session. Supported verbs:\n" +
+				"  select <path[:alias]>      e.g. select uiapi/query/Case/edges/node/Subject/value\n" +
+				"  set [<path>] <key>=<value> e.g. set uiapi/query/Case first=10  |  set uiapi/query/Case where.Status=New\n" +
+				"  var $name <path> [default] e.g. var $id uiapi/query/Case/@args/where/Id/eq (type inferred from path)\n" +
+				'Each command is tokenized on spaces and a value MUST NOT contain a space — quoting does not help once a token has started (key=\'a b\' still splits). A filter value that contains a space (e.g. "New York", "In Progress") cannot be expressed via set in v1; use sf_gql_list with a JSON filter, or pass the value through a variable bound with var.\n' +
+				"Fails fast: a bad command aborts the whole call. Other CLI verbs (cd, drop, alias, optional, unset) are NOT supported in v1.",
+		),
+	operation: z
+		.enum(["query", "mutation", "aggregate"])
+		.optional()
+		.describe(
+			'Operation root. "query" (default) → uiapi.query; "mutation" → mutation root; "aggregate" → uiapi.aggregate.',
+		),
+	typeName: graphqlName(
+		"Override the GraphQL operation name. Defaults to Raw<Operation>.",
+	).optional(),
+});
+
+// --- sf_gql_create ----------------------------------------------------------
+
+export const CREATE_INPUT = z.object({
+	org: z.string().describe("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
+	object: graphqlName('SObject API name, e.g. "Account", "Order". Must be a valid GraphQL Name.'),
+	returnFields: z
+		.array(z.string())
+		.optional()
+		.describe(
+			'Scalar field API names to read back on the created Record. Defaults to ["Id"]. Dot-paths like Owner.Name are not supported in mutation results; passing them produces a warning and the field is skipped.',
+		),
+	inputVariable: z
+		.string()
+		.optional()
+		.describe(
+			'Variable name (without "$") for the create input. Defaults to "input". Declared as $<name>: <Object>CreateInput!.',
+		),
+	operationName: graphqlName(
+		"Override the GraphQL operation name. Defaults to Create<Object>.",
+	).optional(),
+});
+
+// --- sf_gql_update ----------------------------------------------------------
+
+export const UPDATE_INPUT = z.object({
+	org: z.string().describe("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
+	object: graphqlName('SObject API name, e.g. "Account", "Order". Must be a valid GraphQL Name.'),
+	returnFields: z
+		.array(z.string())
+		.optional()
+		.describe(
+			'Scalar field API names to read back on the updated Record. Defaults to ["Id"]. Dot-paths like Owner.Name are not supported in mutation results; passing them produces a warning and the field is skipped.',
+		),
+	inputVariable: z
+		.string()
+		.optional()
+		.describe(
+			'Variable name (without "$") for the update input. Defaults to "input". Declared as $<name>: <Object>UpdateInput!.',
+		),
+	operationName: graphqlName(
+		"Override the GraphQL operation name. Defaults to Update<Object>.",
+	).optional(),
+});
+
+// --- sf_gql_delete ----------------------------------------------------------
+
+export const DELETE_INPUT = z.object({
+	org: z.string().describe("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
+	object: graphqlName('SObject API name, e.g. "Account", "Order". Must be a valid GraphQL Name.'),
+	inputVariable: z
+		.string()
+		.optional()
+		.describe(
+			'Variable name (without "$") for the delete input. Defaults to "input". Declared as $<name>: RecordDeleteInput! — the schema-wide delete input carrying the record Id, not an <Object>-specific type.',
+		),
+	operationName: graphqlName(
+		"Override the GraphQL operation name. Defaults to Delete<Object>.",
+	).optional(),
+});
+
+// --- sf_gql_connect ---------------------------------------------------------
+
+export const CONNECT_INPUT = z.object({
+	org: orgAlias("Org alias or username resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
+	forceRefresh: z
+		.boolean()
+		.optional()
+		.describe(
+			"Re-download the schema even if it is already cached, clearing the on-disk introspection JSON, the in-memory parsed schema, and the ObjectInfo cache. Use after deploying new metadata (fields, picklist values, objects) so subsequent tools see the changes. Defaults to false.",
+		),
+});

package/dist/mcp/tools/shared/zod-schemas.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"zod-schemas.js","sourceRoot":"","sources":["../../../../src/mcp/tools/shared/zod-schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,WAAmB,EAAe,EAAE,CAC/D,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,8BAA8B,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,YAAY,GAAG,uCAAuC,CAAC;AAC7D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,WAAmB,EAAe,EAAE,CAC5D,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,uCAAuC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAE/F;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,OAAqB,EAAE,EAAE,CAChE,CAAC,CAAC,MAAM,CAAC;IACR,gBAAgB,EAAE,WAAW,CAC5B,8FAA8F,CAC9F;IACD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;CAC3B,CAAC,CAAC"}

package/dist/{mcp/tools/shared/zod-schemas.d.ts → schemas/fields.d.ts}

@@ -35,14 +35,14 @@ export declare const childRelationshipSchema: (orderBy: z.ZodTypeAny) => z.ZodOb
     filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     orderBy: z.ZodOptional<z.ZodTypeAny>;
 }, "strip", z.ZodTypeAny, {
-    fields: string[];
     relationshipName: string;
+    fields: string[];
     filter?: Record<string, unknown> | undefined;
     orderBy?: any;
     first?: number | undefined;
 }, {
-    fields: string[];
     relationshipName: string;
+    fields: string[];
     filter?: Record<string, unknown> | undefined;
     orderBy?: any;
     first?: number | undefined;