@salesforce/graphiti 10.10.2

package/dist/mcp/tools/sf-gql-raw.js

@@ -0,0 +1,39 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { z } from "zod";
+import { buildRaw } from "../../intent/build-raw.js";
+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: z
+        .string()
+        .optional()
+        .describe("Codegen type prefix / operation name override. Defaults to Raw<Operation>."),
+};
+export function registerSfGqlRawTool(server, opts = {}) {
+    server.registerTool("sf_gql_raw", {
+        description: "Low-level escape hatch: build an arbitrary UIAPI query, mutation, or aggregate from CLI-style commands (select/set/var) when the typed tools don't model the case (cross-union selections, custom mutations). Returns rendered GraphQL, declared variables, generated TypeScript types, and validation warnings. Fails fast on a bad command.",
+        inputSchema,
+    }, async (args) => {
+        const output = await buildRaw(args, opts.primeDeps);
+        return {
+            content: [{ type: "text", text: JSON.stringify(output) }],
+        };
+    });
+}
+//# sourceMappingURL=sf-gql-raw.js.map

package/dist/mcp/tools/sf-gql-raw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sf-gql-raw.js","sourceRoot":"","sources":["../../../src/mcp/tools/sf-gql-raw.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAOrD,MAAM,WAAW,GAAG;IACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IAC9F,QAAQ,EAAE,CAAC;SACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACR,gFAAgF;QAC/E,sFAAsF;QACtF,6GAA6G;QAC7G,0GAA0G;QAC1G,2VAA2V;QAC3V,8HAA8H,CAC/H;IACF,SAAS,EAAE,CAAC;SACV,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;SACxC,QAAQ,EAAE;SACV,QAAQ,CACR,6GAA6G,CAC7G;IACF,QAAQ,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4EAA4E,CAAC;CACxF,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,OAA4B,EAAE;IACrF,MAAM,CAAC,YAAY,CAClB,YAAY,EACZ;QACC,WAAW,EACV,+UAA+U;QAChV,WAAW;KACX,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACpD,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;SACzD,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/mcp/tools/sf-gql-update.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type PrimeDeps } from "../../lib/prime-schema.js";
+export interface SfGqlUpdateToolOptions {
+    primeDeps?: PrimeDeps;
+}
+export declare function registerSfGqlUpdateTool(server: McpServer, opts?: SfGqlUpdateToolOptions): void;

package/dist/mcp/tools/sf-gql-update.js

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { z } from "zod";
+import { buildUpdate } from "../../intent/build-update.js";
+const inputSchema = {
+    org: z.string().describe("Org alias resolved via local Salesforce CLI auth (~/.sf, ~/.sfdx)."),
+    object: z.string().describe('SObject API name, e.g. "Account", "Order".'),
+    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: z
+        .string()
+        .optional()
+        .describe("Override the GraphQL operation name. Defaults to Update<Object>."),
+};
+export function registerSfGqlUpdateTool(server, opts = {}) {
+    server.registerTool("sf_gql_update", {
+        description: "Build a UIAPI update mutation against a Salesforce org. Declares a typed input variable ($input: <Object>UpdateInput!) and selects return fields on the updated record. Returns rendered GraphQL, declared variables, generated TypeScript types, and validation warnings.",
+        inputSchema,
+    }, async (args) => {
+        const output = await buildUpdate(args, opts.primeDeps);
+        return {
+            content: [{ type: "text", text: JSON.stringify(output) }],
+        };
+    });
+}
+//# sourceMappingURL=sf-gql-update.js.map

package/dist/mcp/tools/sf-gql-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sf-gql-update.js","sourceRoot":"","sources":["../../../src/mcp/tools/sf-gql-update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAO3D,MAAM,WAAW,GAAG;IACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IAC9F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACzE,YAAY,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACR,2MAA2M,CAC3M;IACF,aAAa,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACR,mHAAmH,CACnH;IACF,aAAa,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;CAC9E,CAAC;AAEF,MAAM,UAAU,uBAAuB,CACtC,MAAiB,EACjB,OAA+B,EAAE;IAEjC,MAAM,CAAC,YAAY,CAClB,eAAe,EACf;QACC,WAAW,EACV,4QAA4Q;QAC7Q,WAAW;KACX,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACvD,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;SACzD,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/mcp/tools/shared/zod-schemas.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { z } from "zod";
+/**
+ * Zod string validator that enforces the GraphQL Name production. Returned
+ * schema is `.describe()`-tagged with the supplied description so it appears
+ * in the MCP tool's advertised JSON Schema.
+ */
+export declare const graphqlName: (description: string) => z.ZodString;
+export declare const orgAlias: (description: string) => z.ZodString;
+/**
+ * `<Object>_OrderBy` shape. UIAPI accepts a singleton object; tools may
+ * additionally accept arrays as a compat shim depending on their advertised
+ * schema policy (see `sf-gql-list.ts` vs `sf-gql-detail.ts`).
+ */
+export declare const orderByObject: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/**
+ * Build a `childRelationships[]` element schema. The `orderBy` schema is a
+ * parameter because tools differ on whether they advertise the array shape
+ * (`sf_gql_list`: union; `sf_gql_detail`: singleton with array-collapse
+ * preprocess). Everything else — `relationshipName`, `fields`, `first`,
+ * `filter` — is identical across callers.
+ *
+ * `relationshipName` flows into a rendered field-path position in the
+ * resulting query, so it carries the same GraphQL Name constraint as
+ * top-level `object` — same failure mode if it's invalid.
+ */
+export declare const childRelationshipSchema: (orderBy: z.ZodTypeAny) => z.ZodObject<{
+    relationshipName: z.ZodString;
+    fields: z.ZodArray<z.ZodString, "many">;
+    first: z.ZodOptional<z.ZodNumber>;
+    filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    orderBy: z.ZodOptional<z.ZodTypeAny>;
+}, "strip", z.ZodTypeAny, {
+    fields: string[];
+    relationshipName: string;
+    filter?: Record<string, unknown> | undefined;
+    orderBy?: any;
+    first?: number | undefined;
+}, {
+    fields: string[];
+    relationshipName: string;
+    filter?: Record<string, unknown> | undefined;
+    orderBy?: any;
+    first?: number | undefined;
+}>;

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

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { z } from "zod";
+import { GRAPHQL_NAME_RE } from "../../../lib/graphql-name.js";
+/**
+ * Zod string validator that enforces the GraphQL Name production. Returned
+ * schema is `.describe()`-tagged with the supplied description so it appears
+ * in the MCP tool's advertised JSON Schema.
+ */
+export const graphqlName = (description) => z.string().regex(GRAPHQL_NAME_RE, "must be a valid GraphQL Name").describe(description);
+/**
+ * Org alias / username charset + length, matching `auth.ts`'s
+ * `assertValidOrgAlias`. Defense-in-depth at the MCP boundary so the
+ * advertised JSON Schema teaches the LLM the constraint upfront, while
+ * `assertValidOrgAlias` still gates the shell-out path.
+ */
+const ORG_ALIAS_RE = /^[A-Za-z0-9_][A-Za-z0-9_.+@-]{0,252}$/;
+export const orgAlias = (description) => z.string().regex(ORG_ALIAS_RE, "must be a valid org alias or username").describe(description);
+/**
+ * `<Object>_OrderBy` shape. UIAPI accepts a singleton object; tools may
+ * additionally accept arrays as a compat shim depending on their advertised
+ * schema policy (see `sf-gql-list.ts` vs `sf-gql-detail.ts`).
+ */
+export const orderByObject = z.record(z.unknown());
+/**
+ * Build a `childRelationships[]` element schema. The `orderBy` schema is a
+ * parameter because tools differ on whether they advertise the array shape
+ * (`sf_gql_list`: union; `sf_gql_detail`: singleton with array-collapse
+ * preprocess). Everything else — `relationshipName`, `fields`, `first`,
+ * `filter` — is identical across callers.
+ *
+ * `relationshipName` flows into a rendered field-path position in the
+ * resulting query, so it carries the same GraphQL Name constraint as
+ * top-level `object` — same failure mode if it's invalid.
+ */
+export const childRelationshipSchema = (orderBy) => z.object({
+    relationshipName: graphqlName('Child relationship API name, e.g. "Contacts", "Opportunities". Must be a valid GraphQL Name.'),
+    fields: z.array(z.string()),
+    first: z.number().int().positive().optional(),
+    filter: z.record(z.unknown()).optional(),
+    orderBy: orderBy.optional(),
+});
+//# sourceMappingURL=zod-schemas.js.map

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

@@ -0,0 +1 @@
+{"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/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@salesforce/graphiti",
+  "version": "10.10.2",
+  "description": "Progressive GraphQL query builder CLI for Salesforce orgs",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "type": "module",
+  "bin": {
+    "graphiti": "./dist/cli.js",
+    "graphiti-mcp": "./dist/mcp/stdio.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@salesforce/core": "^8.23.4",
+    "commander": "^13.1.0",
+    "graphql": "^16.10.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "@vitest/coverage-v8": "^4.0.6",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/ralph-loop.sh

@@ -0,0 +1,120 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Ralph loop: repeatedly hand a TASK.md file to Claude and let it iterate.
+#
+# All task-specific instructions (phases, rules, priorities, tools, etc.)
+# belong in the task file itself — this script stays generic and just drives
+# the loop.
+#
+# Usage:
+#   ./ralph-loop.sh [TASK_FILE] [ITERATIONS]
+#
+# Environment variables:
+#   TASK_FILE      Path to the task markdown file (default: TASK.md)
+#   ITERATIONS     Number of iterations to run (default: 100)
+#   REFLECTION_FILE Path to the reflection file the agent reads/writes
+#                  between runs (default: REFLECTION.md)
+#   MODEL          Claude model to use (default: opus)
+#   WORK_DIR       Directory to run the loop in (default: script dir)
+#   PRE_CMD        Optional command to run once before the loop starts
+#   ITER_CMD       Optional command to run after each iteration
+#   LOG_DIR        Where to write per-iteration logs
+#                  (default: $WORK_DIR/ralph-logs)
+#   STOP_FILE      If the agent creates this file, the loop exits early
+#                  (default: DONE)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+TASK_FILE="${1:-${TASK_FILE:-TASK.md}}"
+TOTAL="${2:-${ITERATIONS:-100}}"
+REFLECTION_FILE="${REFLECTION_FILE:-REFLECTION.md}"
+MODEL="${MODEL:-opus}"
+WORK_DIR="${WORK_DIR:-$SCRIPT_DIR}"
+LOG_DIR="${LOG_DIR:-$WORK_DIR/ralph-logs}"
+STOP_FILE="${STOP_FILE:-DONE}"
+
+cd "$WORK_DIR"
+
+if [ ! -f "$TASK_FILE" ]; then
+  echo "ERROR: task file not found: $TASK_FILE" >&2
+  echo "Create a $TASK_FILE describing what you want the agent to do," >&2
+  echo "or pass a path: ./ralph-loop.sh path/to/task.md" >&2
+  exit 1
+fi
+
+mkdir -p "$LOG_DIR"
+
+echo "Ralph loop configuration:"
+echo "  Task file:       $TASK_FILE"
+echo "  Reflection file: $REFLECTION_FILE"
+echo "  Iterations:      $TOTAL"
+echo "  Model:           $MODEL"
+echo "  Work dir:        $WORK_DIR"
+echo "  Log dir:         $LOG_DIR"
+echo ""
+
+if [ -n "${PRE_CMD:-}" ]; then
+  echo "Running PRE_CMD: $PRE_CMD"
+  bash -c "$PRE_CMD"
+fi
+
+for i in $(seq 1 "$TOTAL"); do
+  TIMESTAMP=$(date +%Y%m%d-%H%M%S)
+  LOG_FILE="$LOG_DIR/run-${i}-${TIMESTAMP}.log"
+
+  echo ""
+  echo "========================================="
+  echo "  RALPH LOOP — iteration $i / $TOTAL"
+  echo "  $(date)"
+  echo "  Log: $LOG_FILE"
+  echo "========================================="
+  echo ""
+
+  PROMPT="Read the file $TASK_FILE in this repository and execute it end-to-end. \
+The task file is the source of truth — follow its phases, rules, and priorities exactly. \
+This is iteration $i of $TOTAL. \
+If $REFLECTION_FILE already exists from a previous iteration, read it first and factor in \
+prior learnings — do not repeat the same mistakes, and build on what was already done. \
+Update $REFLECTION_FILE at the end of this iteration with what you learned and what should \
+change next time. \
+Do not ask the user for input at any point — make reasonable decisions and keep going. \
+When all success criteria in the task file are met, create a file named '$STOP_FILE' \
+(just 'touch $STOP_FILE') to signal the loop should stop. Only create it when you are \
+confident the task is fully complete. \
+When you finish, print a concise summary of what you accomplished in this iteration."
+
+  claude \
+    --print \
+    --dangerously-skip-permissions \
+    --model "$MODEL" \
+    --verbose \
+    "$PROMPT" \
+    2>&1 | tee "$LOG_FILE"
+
+  EXIT_CODE=${PIPESTATUS[0]}
+
+  echo ""
+  echo "Iteration $i finished with exit code $EXIT_CODE at $(date)"
+  echo "---"
+
+  if [ "$EXIT_CODE" -ne 0 ]; then
+    echo "WARNING: Iteration $i exited non-zero ($EXIT_CODE). Continuing..."
+  fi
+
+  if [ -n "${ITER_CMD:-}" ]; then
+    echo "Running ITER_CMD: $ITER_CMD"
+    bash -c "$ITER_CMD" || true
+  fi
+
+  if [ -f "$WORK_DIR/$STOP_FILE" ]; then
+    echo ""
+    echo "Stop file found ($STOP_FILE) — task complete, exiting early after iteration $i."
+    break
+  fi
+done
+
+echo ""
+echo "========================================="
+echo "  RALPH LOOP COMPLETE — $TOTAL iterations"
+echo "========================================="

package/scripts/smoke-orderby.sh

@@ -0,0 +1,190 @@
+#!/bin/bash
+# Smoke test: orderBy support for sf_gql_aggregate
+#
+# Tests a105, a114, a115, a119 from the aggregates assignment.
+# Exits 0 only if all 4 pass. Writes results to stdout and
+# SMOKE-RESULTS-orderby.txt for the ralph loop reflection.
+#
+# Usage: cd packages/graphiti && bash scripts/smoke-orderby.sh
+#
+# Prerequisites:
+#   - pnpm build (clean, dist/ up to date)
+#   - ebikes org authenticated via sf CLI (only needed for live runs;
+#     the tool validates the schema cache, not live data)
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+WORK_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$WORK_DIR"
+
+RESULTS_FILE="$WORK_DIR/SMOKE-RESULTS-orderby.txt"
+PASS_COUNT=0
+FAIL_COUNT=0
+DETAILS=""
+
+call_tool() {
+  local args="$1"
+  printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"sf_gql_aggregate","arguments":%s}}\n' "$args" \
+    | FORCE_COLOR=0 NO_COLOR=1 node dist/mcp/stdio.js 2>/dev/null \
+    | sed -n '2p'
+}
+
+extract_query() {
+  python3 -c "
+import sys, json
+line = sys.stdin.read().strip()
+data = json.loads(line)
+content = data.get('result',{}).get('content',[{}])[0].get('text','')
+is_error = data.get('result',{}).get('isError', False)
+if is_error:
+    print('ERROR: ' + content)
+else:
+    parsed = json.loads(content)
+    print(parsed.get('query',''))
+"
+}
+
+normalize() {
+  # Strip whitespace differences for comparison
+  python3 -c "
+import sys, re
+q = sys.stdin.read().strip()
+# Collapse all whitespace to single spaces
+q = re.sub(r'\s+', ' ', q)
+print(q)
+"
+}
+
+check_orderby() {
+  local id="$1"
+  local input="$2"
+  local expected_query="$3"
+  local description="$4"
+
+  local raw_result
+  raw_result=$(call_tool "$input")
+
+  local query
+  query=$(echo "$raw_result" | extract_query)
+
+  local status="FAIL"
+  local note=""
+
+  if echo "$query" | grep -q "^ERROR:"; then
+    note="Tool returned error: $query"
+  else
+    # Normalize both for comparison
+    local actual_norm
+    actual_norm=$(echo "$query" | normalize)
+    local expected_norm
+    expected_norm=$(echo "$expected_query" | normalize)
+
+    if [ "$actual_norm" = "$expected_norm" ]; then
+      status="PASS"
+      note="Query matches expected output exactly"
+    else
+      # Check key structural elements even if not exact match
+      local has_orderby=false
+      local has_function=false
+      local has_order=false
+
+      if echo "$query" | grep -q "orderBy"; then
+        has_orderby=true
+      fi
+      if echo "$query" | grep -q "function:"; then
+        has_function=true
+      fi
+      if echo "$query" | grep -qi "order:.*\(ASC\|DESC\)"; then
+        has_order=true
+      fi
+
+      if [ "$has_orderby" = true ] && [ "$has_function" = true ] && [ "$has_order" = true ]; then
+        # Has the right shape but doesn't match exactly
+        note="Has orderBy with function and order direction but differs from expected.
+Expected: $expected_norm
+Actual:   $actual_norm"
+      elif [ "$has_orderby" = false ]; then
+        note="Missing orderBy clause entirely. Query: $(echo "$query" | head -5)"
+      else
+        note="orderBy present but missing function or order direction.
+Expected: $expected_norm
+Actual:   $actual_norm"
+      fi
+    fi
+  fi
+
+  if [ "$status" = "PASS" ]; then
+    PASS_COUNT=$((PASS_COUNT + 1))
+  else
+    FAIL_COUNT=$((FAIL_COUNT + 1))
+  fi
+
+  local entry="### $id — $description
+**Status:** $status
+**Input:** $input
+**Note:** $note
+**Query output:**
+\`\`\`graphql
+$query
+\`\`\`
+**Expected:**
+\`\`\`graphql
+$expected_query
+\`\`\`
+"
+  DETAILS="${DETAILS}${entry}
+"
+  echo "$status: $id — $note"
+}
+
+echo "=== OrderBy Smoke Tests ==="
+echo ""
+
+# a105: count Leads, groupBy CreatedDate CALENDAR_YEAR, orderBy Description count DESC
+check_orderby \
+  "a105_leads_by_created_year_ordered" \
+  '{"org":"ebikes","object":"Lead","aggregations":[{"function":"count"}],"groupBy":[{"field":"CreatedDate","function":"CALENDAR_YEAR"}],"orderBy":{"Description":{"function":"COUNT","order":"DESC"}},"operationName":"LeadsByCreatedYearOrdered"}' \
+  'query LeadsByCreatedYearOrdered($after: String) { uiapi { aggregate { Lead(groupBy: { CreatedDate: { function: CALENDAR_YEAR } }, orderBy: { Description: { function: COUNT, order: DESC } }, after: $after) { edges { node { aggregate { CreatedDate { value } countId: Id { count { value } } } } } pageInfo { hasNextPage endCursor } } } } }' \
+  "count Leads groupBy CreatedDate CALENDAR_YEAR, orderBy Description count DESC"
+
+# a114: count Opportunities, groupBy AccountId, orderBy Description count DESC
+check_orderby \
+  "a114_opps_by_account_ordered_by_count" \
+  '{"org":"ebikes","object":"Opportunity","aggregations":[{"function":"count"}],"groupBy":["AccountId"],"orderBy":{"Description":{"function":"COUNT","order":"DESC"}},"operationName":"OppsByAccountOrdered"}' \
+  'query OppsByAccountOrdered($after: String) { uiapi { aggregate { Opportunity(groupBy: { AccountId: { group: true } }, orderBy: { Description: { function: COUNT, order: DESC } }, after: $after) { edges { node { aggregate { AccountId { value } countId: Id { count { value } } } } } pageInfo { hasNextPage endCursor } } } } }' \
+  "count Opportunities groupBy AccountId, orderBy Description count DESC"
+
+# a115: count Cases, groupBy Priority, orderBy Description count ASC
+check_orderby \
+  "a115_cases_by_priority_ordered_by_count" \
+  '{"org":"ebikes","object":"Case","aggregations":[{"function":"count"}],"groupBy":["Priority"],"orderBy":{"Description":{"function":"COUNT","order":"ASC"}},"operationName":"CasesByPriorityOrdered"}' \
+  'query CasesByPriorityOrdered($after: String) { uiapi { aggregate { Case(groupBy: { Priority: { group: true } }, orderBy: { Description: { function: COUNT, order: ASC } }, after: $after) { edges { node { aggregate { Priority { value } countId: Id { count { value } } } } } pageInfo { hasNextPage endCursor } } } } }' \
+  "count Cases groupBy Priority, orderBy Description count ASC"
+
+# a119: count Accounts, groupBy Industry + OwnerId, orderBy Description count DESC
+check_orderby \
+  "a119_accounts_by_industry_and_owner_ordered" \
+  '{"org":"ebikes","object":"Account","aggregations":[{"function":"count"}],"groupBy":["Industry","OwnerId"],"orderBy":{"Description":{"function":"COUNT","order":"DESC"}},"operationName":"AccountsByIndustryOwnerOrdered"}' \
+  'query AccountsByIndustryOwnerOrdered($after: String) { uiapi { aggregate { Account(groupBy: { Industry: { group: true }, OwnerId: { group: true } }, orderBy: { Description: { function: COUNT, order: DESC } }, after: $after) { edges { node { aggregate { Industry { value } OwnerId { value } countId: Id { count { value } } } } } pageInfo { hasNextPage endCursor } } } } }' \
+  "count Accounts groupBy Industry + OwnerId, orderBy Description count DESC"
+
+echo ""
+echo "=== Summary: $PASS_COUNT PASS, $FAIL_COUNT FAIL ==="
+
+# Write results file for reflection
+cat > "$RESULTS_FILE" <<EOF
+# Smoke Test Results — OrderBy
+# Run: $(date)
+# Pass: $PASS_COUNT / 4
+# Fail: $FAIL_COUNT / 4
+
+$DETAILS
+EOF
+
+echo "Results written to $RESULTS_FILE"
+
+if [ "$FAIL_COUNT" -gt 0 ]; then
+  exit 1
+fi
+exit 0

package/src/__tests__/helpers/prime-deps.ts

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import path from "node:path";
+import { type GraphQLSchema, introspectionFromSchema } from "graphql";
+import { atomicWriteJson } from "../../lib/fs-utils.js";
+import {
+	schemaCacheKeyForInstanceUrl,
+	schemaDir,
+	type SchemaMetadata,
+} from "../../lib/introspect.js";
+import { type PrimeDeps } from "../../lib/prime-schema.js";
+
+/**
+ * Build a `PrimeDeps` whose `downloadSchema` writes the supplied schema to
+ * `schemaDir()` — redirected to a tmpdir by the global test setup — so
+ * intent-layer tests exercise the priming hook without keychain or network
+ * access. Mirrors the real `downloadSchema` contract.
+ */
+export function makeNoopPrimeDeps(org: string, orgUrl: string, schema: GraphQLSchema): PrimeDeps {
+	return {
+		getOrgAuth: async () => ({
+			alias: org,
+			username: "u",
+			instanceUrl: orgUrl,
+			accessToken: "t",
+			orgId: "00D",
+		}),
+		downloadSchema: async (auth) => {
+			const cacheKey = schemaCacheKeyForInstanceUrl(auth.instanceUrl);
+			const filePath = path.join(schemaDir(), `${cacheKey}.json`);
+			atomicWriteJson(filePath, { data: introspectionFromSchema(schema) });
+			const meta: SchemaMetadata = {
+				cacheKey,
+				instanceUrl: auth.instanceUrl,
+				typeCount: 0,
+				downloadedAt: new Date().toISOString(),
+				filePath,
+			};
+			return meta;
+		},
+	};
+}

package/src/__tests__/helpers/schema.ts

@@ -0,0 +1,73 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import { buildSchema } from "graphql";
+import { createSession } from "../../lib/session.js";
+import { primeSchemaCache } from "../../lib/walker.js";
+
+/**
+ * Test schema covering the union of types referenced across legacy graphiti
+ * test files. Intentionally minimal — extend only when new tests need new types.
+ */
+export const TEST_SCHEMA = buildSchema(`
+	type Query {
+		viewer: Viewer!
+		accounts(first: Int, where: AccountFilter): AccountConnection!
+		search: [SearchHit!]!
+	}
+
+	type Mutation {
+		createAccount(input: CreateAccountInput!): Account!
+	}
+
+	type Viewer {
+		id: ID!
+		name: String!
+	}
+
+	input AccountFilter {
+		minRevenue: Int
+		name: StringFilter
+	}
+
+	input StringFilter {
+		eq: String
+		like: String
+	}
+
+	input CreateAccountInput {
+		name: String!
+	}
+
+	type AccountConnection {
+		edges: [AccountEdge!]!
+	}
+
+	type AccountEdge {
+		node: Account!
+	}
+
+	type Account {
+		id: ID!
+		name: String!
+		annualRevenue: Float
+	}
+
+	type Contact {
+		id: ID!
+		name: String!
+		email: String
+	}
+
+	union SearchHit = Account | Contact
+`);
+
+export function makeSession(operation: "query" | "mutation" = "query") {
+	const alias = `test_${Math.random().toString(16).slice(2, 8)}`;
+	const instanceUrl = `https://${alias}.my.salesforce.com`;
+	primeSchemaCache(instanceUrl, TEST_SCHEMA);
+	return createSession(alias, operation, instanceUrl);
+}