@salesforce/graphiti 10.10.2

package/dist/commands/describe.js

@@ -0,0 +1,229 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any -- graphiti traverses untyped schema/introspection JSON; see follow-up to replace with `unknown` + narrowing */
+import { getOrgAuth } from "../lib/auth.js";
+import { getObjectInfo, getRequiredCreateFields, } from "../lib/object-info.js";
+import { getSchema, inspectType } from "../lib/walker.js";
+export async function describeCommand(orgAlias, sObjectName) {
+    const auth = await getOrgAuth(orgAlias);
+    const schema = getSchema(auth.instanceUrl);
+    let objInfo = null;
+    try {
+        objInfo = await getObjectInfo(auth, orgAlias, sObjectName);
+    }
+    catch {
+        // Fall back to schema-only
+    }
+    if (!objInfo) {
+        console.log(`Could not fetch ObjectInfo for "${sObjectName}". Showing schema-only view.`);
+        console.log("");
+        showSchemaOnlyView(schema, sObjectName);
+        return;
+    }
+    const _metaByApi = new Map(objInfo.fields.map((f) => [f.apiName, f]));
+    // Object header
+    const capabilities = [];
+    if (objInfo.queryable)
+        capabilities.push("queryable");
+    if (objInfo.createable)
+        capabilities.push("createable");
+    if (objInfo.updateable)
+        capabilities.push("updateable");
+    if (objInfo.deletable)
+        capabilities.push("deletable");
+    if (objInfo.searchable)
+        capabilities.push("searchable");
+    console.log(`${sObjectName}  "${objInfo.labelPlural ?? objInfo.label ?? sObjectName}"  (keyPrefix: ${objInfo.keyPrefix ?? "n/a"}, nameField: ${objInfo.nameFields.join(", ") || "n/a"})`);
+    console.log(`  ${capabilities.join(", ")}`);
+    if (objInfo.recordTypeInfos.length > 1) {
+        const available = objInfo.recordTypeInfos.filter((r) => r.available);
+        console.log(`  Record types: ${available.map((r) => r.name).join(", ")}`);
+    }
+    console.log("");
+    // Fields table
+    console.log(`Fields (${objInfo.fields.length}):`);
+    const sortedFields = [...objInfo.fields].sort((a, b) => {
+        // Name field first, then required, then alphabetical
+        if (a.nameField && !b.nameField)
+            return -1;
+        if (!a.nameField && b.nameField)
+            return 1;
+        if (a.required && !b.required)
+            return -1;
+        if (!a.required && b.required)
+            return 1;
+        return a.apiName.localeCompare(b.apiName);
+    });
+    for (const field of sortedFields) {
+        const line = formatFieldRow(field, objInfo);
+        console.log(`  ${line}`);
+    }
+    // Create fields
+    const createFields = objInfo.fields.filter((f) => f.createable);
+    const requiredOnCreate = getRequiredCreateFields(objInfo);
+    if (createFields.length > 0) {
+        console.log("");
+        console.log(`Create fields (${createFields.length}):  ${createFields.map((f) => f.apiName).join(", ")}`);
+        if (requiredOnCreate.length > 0) {
+            console.log(`  Required on create: ${requiredOnCreate.map((f) => f.apiName).join(", ")}`);
+        }
+        else {
+            console.log("  Required on create: (none -- all have defaults or are optional)");
+        }
+    }
+    // Update fields
+    const updateFields = objInfo.fields.filter((f) => f.updateable);
+    if (updateFields.length > 0) {
+        console.log("");
+        console.log(`Update fields (${updateFields.length}):  ${updateFields.map((f) => f.apiName).join(", ")}`);
+        const createOnly = objInfo.fields.filter((f) => f.createable && !f.updateable);
+        if (createOnly.length > 0) {
+            console.log(`  Create-only (cannot update): ${createOnly.map((f) => f.apiName).join(", ")}`);
+        }
+    }
+    // Child relationships
+    const namedRels = objInfo.childRelationships.filter((cr) => cr.relationshipName);
+    if (namedRels.length > 0) {
+        console.log("");
+        console.log(`Child relationships (${namedRels.length}):`);
+        for (const cr of namedRels.slice(0, 20)) {
+            console.log(`  ${cr.relationshipName.padEnd(30)} -> ${cr.childObjectApiName}.${cr.fieldName}`);
+        }
+        if (namedRels.length > 20) {
+            console.log(`  ... ${namedRels.length - 20} more`);
+        }
+    }
+    // Picklists summary
+    if (objInfo.picklists.length > 0) {
+        console.log("");
+        console.log(`Picklist fields (${objInfo.picklists.length}):`);
+        for (const pl of objInfo.picklists) {
+            const vals = pl.values.map((v) => v.value).filter((v) => v !== null);
+            console.log(`  ${pl.apiName.padEnd(25)} ${vals.join(", ")}`);
+        }
+    }
+    // Filter and OrderBy examples
+    console.log("");
+    console.log("Filter examples:");
+    const filterableFields = objInfo.fields.filter((f) => f.filterable && !f.compound);
+    const picklistField = filterableFields.find((f) => f.dataType === "PICKLIST");
+    const stringField = filterableFields.find((f) => f.dataType === "STRING" && f.filterable);
+    const dateField = filterableFields.find((f) => f.dataType === "DATETIME" && f.filterable);
+    if (picklistField) {
+        const pl = objInfo.picklists.find((p) => p.apiName === picklistField.apiName);
+        const val = pl?.values[0]?.value ?? "<value>";
+        console.log(`  { "${picklistField.apiName}": { "eq": "${val}" } }`);
+    }
+    if (stringField) {
+        console.log(`  { "${stringField.apiName}": { "like": "%search%" } }`);
+    }
+    if (picklistField && dateField) {
+        console.log(`  { "and": [{ "${picklistField.apiName}": { "eq": "<value>" } }, { "${dateField.apiName}": { "gt": "2024-01-01T00:00:00Z" } }] }`);
+    }
+    const sortableFields = objInfo.fields.filter((f) => f.sortable && !f.compound);
+    if (sortableFields.length > 0) {
+        console.log("");
+        console.log("OrderBy examples:");
+        const first = sortableFields[0];
+        console.log(`  { "${first.apiName}": { "order": "DESC" } }`);
+        if (sortableFields.length > 1) {
+            console.log(`  { "${sortableFields[0].apiName}": { "order": "ASC" }, "${sortableFields[1].apiName}": { "order": "DESC" } }`);
+        }
+    }
+}
+function formatFieldRow(field, objInfo) {
+    const name = field.apiName.padEnd(28);
+    const dataType = (field.dataType ?? "UNKNOWN").padEnd(14);
+    const label = field.label && field.label !== field.apiName ? `"${field.label}"` : "";
+    const tags = [];
+    if (field.required && field.createable && !field.defaultedOnCreate)
+        tags.push("required");
+    if (field.required && field.defaultedOnCreate)
+        tags.push("auto");
+    if (field.nameField)
+        tags.push("name-field");
+    if (!field.filterable)
+        tags.push("no-filter");
+    if (!field.sortable)
+        tags.push("no-sort");
+    if (!field.createable && !field.updateable)
+        tags.push("read-only");
+    if (field.createable && !field.updateable)
+        tags.push("create-only");
+    if (field.defaultedOnCreate && field.createable)
+        tags.push("default-on-create");
+    if (field.calculated)
+        tags.push("formula");
+    if (field.custom)
+        tags.push("custom");
+    if (field.compound)
+        tags.push("compound");
+    if (field.compoundFieldName)
+        tags.push(`child of ${field.compoundFieldName}`);
+    let extra = "";
+    if (field.reference && field.referenceToInfos.length > 0) {
+        const targets = field.referenceToInfos.map((r) => {
+            const nameFields = r.nameFields.length > 0 ? ` (${r.nameFields.join(", ")})` : "";
+            return `${r.apiName}${nameFields}`;
+        });
+        extra = `-> ${targets.join(", ")}`;
+    }
+    const picklist = objInfo.picklists.find((p) => p.apiName === field.apiName);
+    if (picklist && picklist.values.length > 0) {
+        const vals = picklist.values.map((v) => v.value).filter((v) => v !== null);
+        if (vals.length <= 6) {
+            extra = `values: [${vals.join(", ")}]`;
+        }
+        else {
+            extra = `values: [${vals.slice(0, 5).join(", ")}, ... +${vals.length - 5}]`;
+        }
+    }
+    if (field.extraTypeInfo) {
+        extra += extra ? ` (${field.extraTypeInfo})` : `(${field.extraTypeInfo})`;
+    }
+    if (field.precision > 0) {
+        extra += extra ? ` precision=${field.precision}` : `precision=${field.precision}`;
+        if (field.scale > 0)
+            extra += `,scale=${field.scale}`;
+    }
+    if (field.inlineHelpText) {
+        extra += extra ? ` -- ${field.inlineHelpText}` : field.inlineHelpText;
+    }
+    const tagStr = tags.length > 0 ? `[${tags.join(", ")}]` : "";
+    const labelStr = label ? `  ${label}` : "";
+    return `${name} ${dataType}${labelStr}  ${tagStr}  ${extra}`.trimEnd();
+}
+function showSchemaOnlyView(schema, typeName) {
+    try {
+        const info = inspectType(schema, typeName);
+        console.log(`${typeName} (${info.kind})`);
+        if (info.description)
+            console.log(`  ${info.description}`);
+        console.log("");
+        if (info.fields.length > 0) {
+            console.log("Fields:");
+            for (const f of info.fields) {
+                console.log(`  ${f.name.padEnd(28)} ${f.typeName}${f.isNonNull ? "!" : ""}`);
+            }
+        }
+        if (info.inputFields.length > 0) {
+            console.log("Input fields:");
+            for (const f of info.inputFields) {
+                console.log(`  ${f.name.padEnd(28)} ${f.typeName}${f.isNonNull ? "!" : ""}`);
+            }
+        }
+        if (info.enumValues.length > 0) {
+            console.log("Values:");
+            for (const v of info.enumValues) {
+                console.log(`  ${v.name}${v.description ? `  -- ${v.description}` : ""}`);
+            }
+        }
+    }
+    catch (_e) {
+        console.error(`Type "${typeName}" not found in schema.`);
+    }
+}
+//# sourceMappingURL=describe.js.map

package/dist/commands/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/commands/describe.ts"],"names":[],"mappings":"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"}

package/dist/commands/meta.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { type InputWalkerResult } from "../lib/walker.js";
+export declare function queryExample(sessionId: string): void;
+export declare function printInputExamples(inputResult: InputWalkerResult, cmd: string): void;
+export declare function queryHelp(sessionId: string | undefined, topic?: string): void;

package/dist/commands/meta.js

@@ -0,0 +1,140 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { getSessionSchema } from "./query-helpers.js";
+import { formatHelp } from "../lib/query-commands.js";
+import { loadSession, getNavigationContext, isInArgsContext, queryNavToSchemaPath, getArgsFieldPath, getInputSubPath, parseVariablePath, } from "../lib/session.js";
+import { formatPath } from "../lib/session.js";
+import { getRootFields, resolveArgByName, resolveInputPath, resolvePath, } from "../lib/walker.js";
+export function queryExample(sessionId) {
+    const session = loadSession(sessionId);
+    const ctx = getNavigationContext(session.navigationPath);
+    const schema = getSessionSchema(session);
+    if (ctx === "root" || session.navigationPath.length === 0) {
+        console.log("At root. Navigate into query/ or variables/:");
+        console.log("  cd query          — build the query projection");
+        console.log("  cd variables      — manage query variables");
+        return;
+    }
+    if (ctx === "variables") {
+        const varParsed = parseVariablePath(session.navigationPath);
+        if (!varParsed) {
+            console.log("Define and manage query variables:");
+            console.log("  define $filter AccountWhere      — create with explicit type");
+            console.log("  define $limit Int 10             — with a default value");
+            console.log("  define $filter @args/where       — auto-infer type from a path");
+            console.log("  cd $filter                       — navigate into a complex variable");
+            console.log("  assign $limit 10                 — set a scalar variable value");
+            return;
+        }
+        const variable = session.variables.find((v) => v.name === varParsed.varName);
+        if (!variable)
+            return;
+        const rawType = variable.type.replace(/[![\]]/g, "");
+        const inputResult = resolveInputPath(schema, rawType, varParsed.inputSubPath);
+        printInputExamples(inputResult, "assign");
+        return;
+    }
+    if (isInArgsContext(session.navigationPath)) {
+        const fieldSchemaPath = getArgsFieldPath(session.navigationPath);
+        const inputSubPath = getInputSubPath(session.navigationPath);
+        const wr = resolvePath(schema, session.operation, fieldSchemaPath);
+        if (inputSubPath.length === 0) {
+            console.log(`Arguments for field at ${formatPath(fieldSchemaPath)}:`);
+            for (const arg of wr.args) {
+                const isLeaf = arg.typeKind === "SCALAR" || arg.typeKind === "ENUM";
+                if (isLeaf) {
+                    console.log(`  assign ${arg.name} <value>       — ${arg.typeName}`);
+                }
+                else {
+                    console.log(`  cd ${arg.name}                   — navigate into ${arg.typeName}`);
+                    console.log(`  assign ${arg.name} $var           — or bind a variable`);
+                }
+            }
+            console.log("");
+            console.log("  define $varName @args/where      — auto-infer type and bind");
+            console.log("  define $varName                  — auto-infer from current arg (after cd)");
+            return;
+        }
+        const argName = inputSubPath[0];
+        const argInfo = resolveArgByName(schema, wr, argName);
+        const rawType = argInfo.typeName;
+        const remaining = inputSubPath.slice(1);
+        const inputResult = resolveInputPath(schema, rawType, remaining);
+        printInputExamples(inputResult, "assign");
+        console.log("");
+        console.log("  define $varName                  — auto-infer type and bind to this position");
+        return;
+    }
+    const schemaPath = queryNavToSchemaPath(session.navigationPath);
+    if (schemaPath.length === 0) {
+        const rootFields = getRootFields(schema, session.operation);
+        console.log("Navigate into a field:");
+        for (const f of rootFields.slice(0, 5)) {
+            console.log(`  cd ${f.name}`);
+        }
+        return;
+    }
+    const wr = resolvePath(schema, session.operation, schemaPath);
+    console.log("Select leaf fields:");
+    const leaves = wr.fields.filter((f) => f.typeKind === "SCALAR" || f.typeKind === "ENUM");
+    for (const f of leaves.slice(0, 5)) {
+        const alias = f.name.charAt(0).toLowerCase() + f.name.slice(1);
+        console.log(`  select ${f.name}:${alias}`);
+    }
+    const dirs = wr.fields.filter((f) => f.typeKind !== "SCALAR" && f.typeKind !== "ENUM");
+    if (dirs.length > 0) {
+        console.log("");
+        console.log("Navigate into directories:");
+        for (const f of dirs.slice(0, 3)) {
+            console.log(`  cd ${f.name}`);
+        }
+    }
+    if (wr.args.length > 0) {
+        console.log("");
+        console.log("Configure arguments:");
+        console.log("  cd @args");
+    }
+    console.log("");
+    console.log("Create aliased instances:");
+    if (wr.fields.length > 0) {
+        const f = dirs[0] ?? wr.fields[0];
+        console.log(`  mkdir myAlias ${f.name}`);
+    }
+}
+export function printInputExamples(inputResult, cmd) {
+    if (inputResult.isList) {
+        console.log("List type — add elements with mkdir:");
+        console.log("  mkdir            — add a new element");
+        console.log("  cd 0             — navigate into element 0");
+        return;
+    }
+    const leaves = inputResult.inputFields.filter((f) => f.typeKind === "SCALAR" || f.typeKind === "ENUM");
+    const objs = inputResult.inputFields.filter((f) => f.typeKind !== "SCALAR" && f.typeKind !== "ENUM");
+    if (leaves.length > 0) {
+        console.log("Assign scalar fields:");
+        for (const f of leaves.slice(0, 5)) {
+            console.log(`  ${cmd} ${f.name} <value>        — ${f.typeName}`);
+        }
+    }
+    if (objs.length > 0) {
+        console.log("Navigate into nested types:");
+        for (const f of objs.slice(0, 3)) {
+            console.log(`  cd ${f.name}                   — ${f.typeName}`);
+        }
+    }
+}
+export function queryHelp(sessionId, topic) {
+    if (sessionId) {
+        try {
+            loadSession(sessionId);
+        }
+        catch {
+            // Ignore — still show help even for invalid sessions.
+        }
+    }
+    console.log(formatHelp(topic));
+}
+//# sourceMappingURL=meta.js.map

package/dist/commands/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/commands/meta.ts"],"names":[],"mappings":"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"}

package/dist/commands/navigate.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export declare function queryPwd(sessionId: string): void;
+export declare function queryLs(sessionId: string, opts: {
+    search?: string;
+    regex?: string;
+    long?: boolean;
+    all?: boolean;
+    dataCloud?: boolean;
+}, directories?: string[]): Promise<void>;
+export declare function queryCd(sessionId: string, rawPath: string): void;

package/dist/commands/navigate.js

@@ -0,0 +1,105 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any -- graphiti traverses untyped schema/introspection JSON; see follow-up to replace with `unknown` + narrowing */
+import { CommandError, getSessionSchema, resolveDirectoryPathInSession, resolveAliasSegments, parsePathInput, formatAliasContext, detectSObjectName, printDirectory, } from "./query-helpers.js";
+import { getOrgAuth } from "../lib/auth.js";
+import { formatNavigationPath, parseSearchTerms, parseSearchRegex } from "../lib/formatter.js";
+import { getObjectInfo } from "../lib/object-info.js";
+import { loadSession, saveSession, syncFocusFromNavigationPath, getNavigationContext, isInArgsContext, queryNavToSchemaPath, } from "../lib/session.js";
+import { getRootFields, resolvePath } from "../lib/walker.js";
+export function queryPwd(sessionId) {
+    const session = loadSession(sessionId);
+    console.log(formatNavigationPath(session.navigationPath));
+    const aliasCtx = formatAliasContext(session);
+    if (aliasCtx)
+        console.log(aliasCtx);
+}
+export async function queryLs(sessionId, opts, directories) {
+    const session = loadSession(sessionId);
+    if (opts.long) {
+        const sObjectName = detectSObjectName(session);
+        if (sObjectName) {
+            try {
+                const auth = await getOrgAuth(session.orgAlias);
+                await getObjectInfo(auth, session.orgAlias, sObjectName);
+            }
+            catch {
+                // Ignore — picklist values just won't be shown
+            }
+        }
+    }
+    if (directories && directories.length > 0) {
+        const schema = getSessionSchema(session);
+        for (const rawDir of directories) {
+            const dir = rawDir.includes(".") && !rawDir.includes("/") ? rawDir.replace(/\./g, "/") : rawDir;
+            let resolved = parsePathInput(session.navigationPath, dir);
+            if (resolved.length > 0 && resolved[0] !== "query" && resolved[0] !== "variables") {
+                resolved = ["query", ...resolved];
+            }
+            resolved = resolveAliasSegments(session, resolved);
+            const ctx = getNavigationContext(resolved);
+            if (ctx === "variables" || isInArgsContext(resolved)) {
+                const tempSession = { ...session, navigationPath: resolved };
+                printDirectory(tempSession, opts);
+                continue;
+            }
+            const schemaPath = queryNavToSchemaPath(resolved);
+            if (schemaPath.length === 0) {
+                let rootFields = getRootFields(schema, session.operation);
+                const rootMatcher = opts.regex
+                    ? parseSearchRegex(opts.regex)
+                    : opts.search
+                        ? parseSearchTerms(opts.search)
+                        : undefined;
+                if (rootMatcher) {
+                    rootFields = rootFields.filter((f) => rootMatcher.test(f.name));
+                }
+                console.log(`${rawDir}/`);
+                for (const f of rootFields) {
+                    console.log(`  ${f.name}/`);
+                }
+                console.log("");
+                continue;
+            }
+            let wr;
+            try {
+                wr = resolvePath(schema, session.operation, schemaPath);
+            }
+            catch (e) {
+                console.log(`${rawDir}/ — ${e.message}`);
+                console.log("");
+                continue;
+            }
+            if (wr.isLeaf) {
+                console.log(`${rawDir}  (${wr.typeName}) — leaf field`);
+                console.log("");
+                continue;
+            }
+            console.log(`${rawDir}/`);
+            const tempSession = { ...session, navigationPath: resolved };
+            printDirectory(tempSession, { ...opts, all: opts.all || false });
+            console.log("");
+        }
+        return;
+    }
+    printDirectory(session, opts);
+}
+export function queryCd(sessionId, rawPath) {
+    const session = loadSession(sessionId);
+    let nextPath;
+    try {
+        nextPath = resolveDirectoryPathInSession(session, rawPath);
+    }
+    catch (error) {
+        throw new CommandError(`Invalid path: ${error.message}`);
+    }
+    session.navigationPath = nextPath;
+    syncFocusFromNavigationPath(session);
+    saveSession(session);
+    console.log(formatNavigationPath(session.navigationPath));
+    printDirectory(session, { showFields: false });
+}
+//# sourceMappingURL=navigate.js.map

package/dist/commands/navigate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.js","sourceRoot":"","sources":["../../src/commands/navigate.ts"],"names":[],"mappings":"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"}

package/dist/commands/query-helpers.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { GraphQLSchema } from "graphql";
+import { type AliasEntry, type FieldLongInfo } from "../lib/formatter.js";
+import { type FieldProjectionNode, type OperationType, type ProjectionNode, type QuerySession } from "../lib/session.js";
+import { type InputWalkerResult, type WalkerResult } from "../lib/walker.js";
+export type { WalkerResult, InputWalkerResult, QuerySession, FieldProjectionNode, ProjectionNode };
+export declare class CommandError extends Error {
+    exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare const EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly USER_ERROR: 1;
+    readonly VALIDATION_FAILURE: 2;
+    readonly EXECUTION_FAILURE: 3;
+    readonly AUTH_FAILURE: 4;
+};
+export declare function getSessionSchema(session: QuerySession): GraphQLSchema;
+export declare function walkerResultAtPath(session: QuerySession, navPath?: string[]): WalkerResult;
+export declare function parsePathInput(currentPath: string[], rawPath: string): string[];
+export declare function resolveAliasSegments(session: QuerySession, navPath: string[]): string[];
+export declare function resolveDirectoryPathInSession(session: QuerySession, rawPath: string): string[];
+export declare function resolveArgsPath(session: QuerySession, resolved: string[]): string[];
+export declare function resolveVariablesPath(session: QuerySession, resolved: string[]): string[];
+export declare function getCurrentInstances(session: QuerySession): ProjectionNode[];
+export declare function getActiveInstanceId(session: QuerySession): string | undefined;
+export declare function buildSelectionInfo(session: QuerySession): {
+    selectedFields: Set<string>;
+    optionalFields: Set<string>;
+    aliases: AliasEntry[];
+};
+export declare function buildFieldLongInfo(session: QuerySession, wr: WalkerResult): Map<string, FieldLongInfo>;
+export declare function formatAliasContext(session: QuerySession): string | null;
+export declare function detectSObjectName(session: QuerySession, overridePath?: string[]): string | null;
+export declare function printDirectory(session: QuerySession, opts?: {
+    search?: string;
+    regex?: string;
+    long?: boolean;
+    all?: boolean;
+    showFields?: boolean;
+    dataCloud?: boolean;
+}): void;
+export declare function printArgsDirectory(session: QuerySession, opts?: {
+    search?: string;
+    regex?: string;
+    long?: boolean;
+    all?: boolean;
+    showFields?: boolean;
+}): void;
+export declare function printVariablesDirectory(session: QuerySession, opts?: {
+    search?: string;
+    regex?: string;
+    long?: boolean;
+    all?: boolean;
+    showFields?: boolean;
+}): void;
+export declare function printQuery(session: QuerySession): void;
+export declare function requireFieldDirectory(session: QuerySession): string[];
+export declare function dotPathToSlashPath(dotPath: string): string;
+export declare function selectLeafInSession(session: QuerySession, leafSpec: string, alias?: string): void;
+export declare function pathPointsToArgs(p: string): boolean;
+export declare function resolveArgType(session: QuerySession, fieldSchemaPath: string[], argName: string, inputPath: string[]): {
+    expectedType: string;
+    argTypeKind: string;
+};
+export declare function validateVariableAssignment(session: QuerySession, fieldSchemaPath: string[], argName: string, inputPath: string[], varRef: string): void;
+export declare function validateLiteralAssignment(session: QuerySession, fieldSchemaPath: string[], argName: string, inputPath: string[], value: string, contextHint: string): void;
+export declare function assignViaPath(session: QuerySession, rawPath: string, value: string): void;
+export declare function emitObjectInfoWarnings(session: QuerySession, fieldSchemaPath: string[], argName: string, inputPath: string[], value: string): void;
+export declare function assignInArgsContext(session: QuerySession, segments: string[], value: string): void;
+export declare function assignInVariablesContext(session: QuerySession, segments: string[], value: string, setDefault?: boolean): void;
+export declare function inferTypeFromArgsPath(schema: GraphQLSchema, operation: OperationType, fieldSchemaPath: string[], inputSubPath: string[]): {
+    inferredType: string;
+    argName: string;
+    argInputPath: string[];
+};