import { z } from 'zod';
import { type ProjectType } from '@salesforce/b2c-tooling-sdk/discovery';
/**
 * Human-readable label for each detected workspace/project type, used in the
 * docs tool descriptions so an agent can see what was auto-detected.
 */
export declare const PROJECT_TYPE_LABELS: Record<ProjectType, string>;
/**
 * Accepted values for the docs tools' `workspace` parameter. Mirrors the CLI
 * `--workspace` vocabulary: `auto` uses the auto-detected workspace, `all`
 * disables the preference, or name a concrete type.
 */
export declare const WORKSPACE_VALUES: readonly ["auto", "all", "cartridges", "sfra", "pwa-kit-v3", "storefront-next"];
export type WorkspaceParam = (typeof WORKSPACE_VALUES)[number];
/** Context supplied by the agent for this task, independent of server startup. */
export interface WorkspaceContextInput {
    workspace?: WorkspaceParam;
    projectDirectory?: string;
}
/** Shared discovery inputs; reading documentation never needs instance credentials. */
export declare const workspaceInputSchema: {
    workspace: z.ZodOptional<z.ZodEnum<{
        auto: "auto";
        cartridges: "cartridges";
        sfra: "sfra";
        "pwa-kit-v3": "pwa-kit-v3";
        "storefront-next": "storefront-next";
        all: "all";
    }>>;
    projectDirectory: z.ZodOptional<z.ZodString>;
};
/** Detect only a caller-supplied project, with no startup cwd fallback or cross-call cache. */
export declare function resolveProjectWorkspace(input: WorkspaceContextInput, fallback?: readonly ProjectType[]): Promise<ProjectType[] | undefined>;
/**
 * Resolves the `workspace` tool parameter into the concrete project type(s) to
 * pass to the SDK search, given what was auto-detected at server startup.
 *
 * - `all` → undefined (no workspace preference)
 * - `auto` (or unset) → the detected workspace(s), if any
 * - an explicit type → that type
 */
export declare function resolveWorkspace(param: undefined | WorkspaceParam, detected: readonly ProjectType[]): ProjectType[] | undefined;
/**
 * Builds a short sentence describing the detected workspace for a tool
 * description, or an empty string when nothing was detected.
 */
export declare function detectedWorkspaceNote(detected: readonly ProjectType[]): string;