@salesforce/b2c-dx-mcp 2.1.2 → 3.0.1

package/dist/tools/diagnostics/{mrt-logs-watch-start.js → mrt-logs-watch.js}

@@ -4,6 +4,7 @@
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
 import { z } from 'zod';
+import { createWatchLifecycleTool } from './watch-lifecycle.js';
 import { getProfile, tailMrtLogs } from '@salesforce/b2c-tooling-sdk/operations/mrt';
 import { createToolAdapter, jsonResult } from '../adapter.js';
 import { getMrtLogWatchRegistry } from './mrt-log-watch-registry.js';
@@ -20,24 +21,23 @@ function matchesSearch(entry, search) {
 function matchesLevel(entry, levels) {
     return Boolean(entry.level && levels.has(entry.level.toUpperCase()));
 }
-export function createMrtLogsWatchStartTool(loadServices, serverContext, injections) {
+function createMrtLogsWatchStartTool(loadServices, serverContext, injections) {
     const tailMrtLogsFn = injections?.tailMrtLogs ?? tailMrtLogs;
     const getProfileFn = injections?.getProfile ?? getProfile;
     return createToolAdapter({
-        name: 'mrt_logs_watch_start',
-        description: 'Start a live MRT application-log stream and return watch_id. Start before the target action, poll with ' +
-            'mrt_logs_watch_poll, and always stop with mrt_logs_watch_stop. Requires MRT project and environment.',
+        name: 'mrt_logs_watch',
+        effect: 'read',
+        idempotent: true,
+        openWorld: true,
+        description: 'Start, list, or stop live MRT log watches. Requires project/environment to start; read with mrt_logs_watch_poll. Stop discards unread entries; safe to repeat.',
         toolsets: ['DIAGNOSTICS', 'PWAV3', 'STOREFRONTNEXT'],
         requiresMrtAuth: true,
         inputSchema: {
-            level: z
-                .array(z.string())
-                .optional()
-                .describe('Filter by log level (ERROR, WARN, INFO, DEBUG, etc.). Entries not matching are dropped before buffering.'),
+            level: z.array(z.string()).optional().describe('Keep matching levels before buffering (e.g. ERROR, WARN).'),
             search: z
                 .string()
                 .optional()
-                .describe('Case-insensitive substring filter applied to message and raw text as entries arrive.'),
+                .describe('Case-insensitive substring in message or raw text; filters before buffering.'),
         },
         async execute(args, context) {
             const registry = getMrtLogWatchRegistry(context);
@@ -55,7 +55,7 @@ export function createMrtLogsWatchStartTool(loadServices, serverContext, injecti
             const existing = registry.findByKey(project, environment, origin);
             if (existing) {
                 throw new Error(`An MRT log watch already exists for ${project}/${environment} (watch_id: "${existing.watchId}"). ` +
-                    `Stop it with mrt_logs_watch_stop first, or poll the existing watch.`);
+                    `Stop it with mrt_logs_watch(action: stop) first, or poll the existing watch.`);
             }
             const levelFilter = args.level && args.level.length > 0 ? new Set(args.level.map((l) => l.toUpperCase())) : null;
             const searchFilter = args.search;
@@ -131,4 +131,37 @@ export function createMrtLogsWatchStartTool(loadServices, serverContext, injecti
         formatOutput: (output) => jsonResult(output),
     }, loadServices, serverContext);
 }
-//# sourceMappingURL=mrt-logs-watch-start.js.map
+export function createMrtLogsWatchTool(loadServices, serverContext, injections) {
+    const getRegistry = () => {
+        if (!serverContext)
+            throw new Error('Server context is required for log watches.');
+        return serverContext.mrtLogWatches;
+    };
+    return createWatchLifecycleTool(createMrtLogsWatchStartTool(loadServices, serverContext, injections), () => {
+        return {
+            watches: getRegistry()
+                .listWatches()
+                .map((w) => ({
+                buffered_entries: w.buffer.length,
+                created_at: new Date(w.createdAt).toISOString(),
+                dropped_entries: w.droppedEntries,
+                environment: w.environment,
+                last_activity_at: new Date(w.lastActivityAt).toISOString(),
+                origin: w.origin,
+                project: w.project,
+                stopped: w.stopped,
+                total_entries_seen: w.totalEntriesSeen,
+                watch_id: w.watchId,
+                resolution: w.resolution,
+            })),
+        };
+    }, async (watchId) => {
+        const registry = getRegistry();
+        const watch = registry.getWatch(watchId);
+        const total = watch?.totalEntriesSeen ?? 0;
+        if (watch)
+            await registry.destroyWatch(watchId);
+        return { watch_id: watchId, stopped_at: new Date().toISOString(), total_entries_seen: total };
+    });
+}
+//# sourceMappingURL=mrt-logs-watch.js.map

package/dist/tools/diagnostics/watch-lifecycle.d.ts

@@ -0,0 +1,3 @@
+import type { McpTool } from '../../utils/index.js';
+/** Dispatch before loading configuration: existing watches retain their original target. */
+export declare function createWatchLifecycleTool(start: McpTool, list: () => unknown, stop: (watchId: string) => Promise<unknown>): McpTool;

package/dist/tools/diagnostics/watch-lifecycle.js

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { z } from 'zod';
+import { errorResult, jsonResult } from '../adapter.js';
+/** Dispatch before loading configuration: existing watches retain their original target. */
+export function createWatchLifecycleTool(start, list, stop) {
+    const actionSchema = z.enum(['start', 'list', 'stop']);
+    const schemas = {
+        start: z.object(start.inputSchema).strict(),
+        list: z.object({}).strict(),
+        stop: z.object({ watch_id: z.string().min(1) }).strict(),
+    };
+    return {
+        ...start,
+        inputSchema: {
+            action: actionSchema.describe('start uses configuration/filters; stop needs watch_id; list takes only action.'),
+            ...start.inputSchema,
+            watch_id: z.string().min(1).optional().describe('Required for stop only.'),
+        },
+        async handler({ action, ...args }) {
+            const parsedAction = actionSchema.safeParse(action);
+            if (!parsedAction.success)
+                return errorResult('action must be start, list, or stop.');
+            const parsed = schemas[parsedAction.data].safeParse(args);
+            if (!parsed.success) {
+                const detail = parsed.error.issues
+                    .map((issue) => `${issue.path.join('.') || 'arguments'}: ${issue.message}`)
+                    .join('; ');
+                return errorResult(`Invalid ${parsedAction.data} input: ${detail}`);
+            }
+            try {
+                if (parsedAction.data === 'start')
+                    return await start.handler(args);
+                if (parsedAction.data === 'list')
+                    return jsonResult(list());
+                return jsonResult(await stop(args.watch_id));
+            }
+            catch (error) {
+                return errorResult(error instanceof Error ? error.message : String(error));
+            }
+        },
+    };
+}
+//# sourceMappingURL=watch-lifecycle.js.map

package/dist/tools/docs/docs-list.js

@@ -3,11 +3,12 @@
  * SPDX-License-Identifier: Apache-2
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
+import { TOOLSETS } from '../../utils/constants.js';
 import { z } from 'zod';
 import { listDocs, categoriesForWorkspace } from '@salesforce/b2c-tooling-sdk/docs';
 import { createToolAdapter, jsonResult } from '../adapter.js';
 import { categoryEnumValues, enabledCategoriesNote } from './topics.js';
-import { WORKSPACE_VALUES, detectedWorkspaceNote, resolveWorkspace } from './storefront.js';
+import { workspaceInputSchema, detectedWorkspaceNote, resolveProjectWorkspace, } from './storefront.js';
 /** Default page size for a filtered listing. Bounds payload size (large corpora hold 500+ entries). */
 const DEFAULT_LIMIT = 100;
 /** Projects a full entry to the table-of-contents shape. */
@@ -17,29 +18,32 @@ function toListEntry(entry) {
 export function createDocsListTool(loadServices, detectedWorkspaces = [], enabledCategories) {
     return createToolAdapter({
         name: 'docs_list',
+        effect: 'read',
+        idempotent: true,
+        openWorld: false,
         description: 'List IDs and titles for B2C Commerce (SFCC/Demandware) Script API, job steps, developer guides, admin/merchant help, and tooling docs. ' +
             'Without a filter, returns category counts. ' +
             'Use docs_search for questions and docs_read for content.' +
             enabledCategoriesNote(enabledCategories) +
             detectedWorkspaceNote(detectedWorkspaces),
-        toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
+        toolsets: [...TOOLSETS],
         inputSchema: {
+            ...workspaceInputSchema,
             category: z
                 .enum(categoryEnumValues(enabledCategories))
                 .optional()
                 .describe('Restrict the listing to one documentation category.'),
-            workspace: z
-                .enum(WORKSPACE_VALUES)
-                .optional()
-                .describe('Workspace filter. "auto" uses startup workspace; omit for category directory.'),
+            workspace: workspaceInputSchema.workspace.describe('Filter by storefront; auto detects projectDirectory, all lists categories.'),
             limit: z.number().int().positive().optional().describe(`Max entries per page. Defaults to ${DEFAULT_LIMIT}.`),
             offset: z.number().int().nonnegative().optional().describe('Number of entries to skip (for pagination).'),
         },
         async execute(args) {
             // Explicit category wins; otherwise a workspace narrows to its relevant categories.
-            const workspace = resolveWorkspace(args.workspace, detectedWorkspaces);
+            const workspace = await resolveProjectWorkspace(args, detectedWorkspaces);
             const filter = args.category ??
-                (args.workspace && args.workspace !== 'all' && workspace ? categoriesForWorkspace(workspace) : undefined);
+                ((args.workspace || args.projectDirectory) && args.workspace !== 'all' && workspace
+                    ? categoriesForWorkspace(workspace)
+                    : undefined);
             // No filter at all → return a compact directory of categories + counts,
             // never the whole corpus (which would blow the inline payload budget).
             // The directory itself is bounded by the launch-time allowlist.

package/dist/tools/docs/docs-read.js

@@ -3,20 +3,26 @@
  * SPDX-License-Identifier: Apache-2
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
+import { TOOLSETS } from '../../utils/constants.js';
 import { z } from 'zod';
 import { readDocByQuery } from '@salesforce/b2c-tooling-sdk/docs';
 import { createToolAdapter, errorResult, jsonResult } from '../adapter.js';
 import { enabledCategoriesNote } from './topics.js';
+import { workspaceInputSchema, resolveProjectWorkspace } from './storefront.js';
 /** Default maximum characters of content returned per read call, to bound the inline payload. */
 const DEFAULT_MAX_LENGTH = 12_000;
 export function createDocsReadTool(loadServices, enabledCategories, detectedWorkspaces = []) {
     return createToolAdapter({
         name: 'docs_read',
+        effect: 'read',
+        idempotent: true,
+        openWorld: true,
         description: 'Read a B2C Commerce (SFCC/Demandware) Script API reference, job step, developer guide, admin/merchant help article, or tooling doc by ID or fuzzy query. ' +
             'Use docs_search to find IDs.' +
             enabledCategoriesNote(enabledCategories),
-        toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
+        toolsets: [...TOOLSETS],
         inputSchema: {
+            ...workspaceInputSchema,
             query: z
                 .string()
                 .min(1)
@@ -39,7 +45,7 @@ export function createDocsReadTool(loadServices, enabledCategories, detectedWork
             // picks the same top hit docs_search ranks first. Exact id matches
             // short-circuit inside readDocByQuery before searching, so the boost
             // only affects fuzzy resolution.
-            const workspace = detectedWorkspaces.length > 0 ? [...detectedWorkspaces] : undefined;
+            const workspace = await resolveProjectWorkspace(args, detectedWorkspaces);
             const found = await readDocByQuery(args.query, { enabledCategories, workspace });
             if (!found)
                 return null;

package/dist/tools/docs/docs-schema-list.js

@@ -3,13 +3,17 @@
  * SPDX-License-Identifier: Apache-2
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
+import { TOOLSETS } from '../../utils/constants.js';
 import { listSchemas } from '@salesforce/b2c-tooling-sdk/docs';
 import { createToolAdapter, jsonResult } from '../adapter.js';
 export function createDocsSchemaListTool(loadServices) {
     return createToolAdapter({
         name: 'docs_schema_list',
+        effect: 'read',
+        idempotent: true,
+        openWorld: false,
         description: 'List bundled B2C Commerce (SFCC/Demandware) XSD schema IDs for docs_schema_read.',
-        toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
+        toolsets: [...TOOLSETS],
         inputSchema: {},
         async execute() {
             const entries = listSchemas();

package/dist/tools/docs/docs-schema-read.js

@@ -3,15 +3,19 @@
  * SPDX-License-Identifier: Apache-2
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
+import { TOOLSETS } from '../../utils/constants.js';
 import { z } from 'zod';
 import { readSchemaByQuery } from '@salesforce/b2c-tooling-sdk/docs';
 import { createToolAdapter, errorResult, jsonResult } from '../adapter.js';
 export function createDocsSchemaReadTool(loadServices) {
     return createToolAdapter({
         name: 'docs_schema_read',
+        effect: 'read',
+        idempotent: true,
+        openWorld: false,
         description: 'Read a bundled B2C Commerce (SFCC/Demandware) XSD schema as XML by ID or fuzzy query. ' +
             'Use docs_schema_search to find IDs.',
-        toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
+        toolsets: [...TOOLSETS],
         inputSchema: {
             query: z.string().min(1).describe('Schema name or partial match.'),
         },

package/dist/tools/docs/docs-schema-search.js

@@ -3,15 +3,19 @@
  * SPDX-License-Identifier: Apache-2
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
+import { TOOLSETS } from '../../utils/constants.js';
 import { z } from 'zod';
 import { searchSchemas } from '@salesforce/b2c-tooling-sdk/docs';
 import { createToolAdapter, jsonResult } from '../adapter.js';
 export function createDocsSchemaSearchTool(loadServices) {
     return createToolAdapter({
         name: 'docs_schema_search',
+        effect: 'read',
+        idempotent: true,
+        openWorld: false,
         description: 'Search bundled B2C Commerce (SFCC/Demandware) XSD schemas by ID. ' +
             'Returns matching IDs and scores; use docs_schema_read for content.',
-        toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
+        toolsets: [...TOOLSETS],
         inputSchema: {
             query: z.string().min(1).describe('Schema name or partial match (e.g., "catalog", "order").'),
             limit: z.number().int().positive().optional().describe('Maximum number of results to return. Defaults to 20.'),

package/dist/tools/docs/docs-search.js

@@ -3,11 +3,12 @@
  * SPDX-License-Identifier: Apache-2
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
+import { TOOLSETS } from '../../utils/constants.js';
 import { z } from 'zod';
 import { searchDocs } from '@salesforce/b2c-tooling-sdk/docs';
 import { createToolAdapter, jsonResult } from '../adapter.js';
 import { categoryEnumValues, enabledCategoriesNote } from './topics.js';
-import { WORKSPACE_VALUES, detectedWorkspaceNote, resolveWorkspace } from './storefront.js';
+import { workspaceInputSchema, detectedWorkspaceNote, resolveProjectWorkspace, } from './storefront.js';
 /** Default number of results returned when `limit` is not supplied. Kept small to bound payload size for agents. */
 const DEFAULT_LIMIT = 5;
 /**
@@ -38,18 +39,18 @@ function leanResult(entry, score, verbose) {
 export function createDocsSearchTool(loadServices, detectedWorkspaces = [], enabledCategories) {
     return createToolAdapter({
         name: 'docs_search',
+        effect: 'read',
+        idempotent: true,
+        openWorld: false,
         description: 'Search B2C Commerce (SFCC/Demandware) Script API, job steps, developer guides, admin/merchant help, and tooling docs. ' +
             'Use for natural-language queries or unknown IDs; call docs_read with a result ID.' +
             enabledCategoriesNote(enabledCategories) +
             detectedWorkspaceNote(detectedWorkspaces),
-        toolsets: ['CARTRIDGES', 'DIAGNOSTICS', 'MRT', 'PWAV3', 'SCAPI', 'STOREFRONTNEXT'],
+        toolsets: [...TOOLSETS],
         inputSchema: {
+            ...workspaceInputSchema,
             query: z.string().min(1).describe('Search query (class name, topic, or natural-language phrase).'),
             category: z.enum(categoryEnumValues(enabledCategories)).optional().describe('Restrict results to one corpus.'),
-            workspace: z
-                .enum(WORKSPACE_VALUES)
-                .optional()
-                .describe('"auto" uses startup workspace; "all" disables weighting; or select a workspace type.'),
             limit: z
                 .number()
                 .int()
@@ -68,7 +69,7 @@ export function createDocsSearchTool(loadServices, detectedWorkspaces = [], enab
                 .describe('Include keywords and canonical url on each result (larger payload). Defaults to false.'),
         },
         async execute(args) {
-            const workspace = resolveWorkspace(args.workspace, detectedWorkspaces);
+            const workspace = await resolveProjectWorkspace(args, detectedWorkspaces);
             const limit = args.limit ?? DEFAULT_LIMIT;
             const offset = args.offset ?? 0;
             // The SDK returns top-N search hits. Retrieve the complete ranked set here

package/dist/tools/docs/storefront.d.ts

@@ -1,4 +1,5 @@
-import type { ProjectType } from '@salesforce/b2c-tooling-sdk/discovery';
+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.
@@ -11,6 +12,25 @@ export declare const PROJECT_TYPE_LABELS: Record<ProjectType, string>;
  */
 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.

package/dist/tools/docs/storefront.js

@@ -3,6 +3,9 @@
  * SPDX-License-Identifier: Apache-2
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
+import { isAbsolute } from 'node:path';
+import { z } from 'zod';
+import { detectWorkspaceType } 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.
@@ -19,6 +22,28 @@ export const PROJECT_TYPE_LABELS = {
  * disables the preference, or name a concrete type.
  */
 export const WORKSPACE_VALUES = ['auto', 'all', 'cartridges', 'sfra', 'pwa-kit-v3', 'storefront-next'];
+/** Shared discovery inputs; reading documentation never needs instance credentials. */
+export const workspaceInputSchema = {
+    workspace: z
+        .enum(WORKSPACE_VALUES)
+        .optional()
+        .describe('Storefront preference; auto detects projectDirectory, all disables bias.'),
+    projectDirectory: z
+        .string()
+        .min(1)
+        .refine(isAbsolute, 'Use an absolute project directory.')
+        .optional()
+        .describe('Project to detect for this call; never defaults to the server directory.'),
+};
+/** Detect only a caller-supplied project, with no startup cwd fallback or cross-call cache. */
+export async function resolveProjectWorkspace(input, fallback = []) {
+    if (input.workspace && input.workspace !== 'auto')
+        return resolveWorkspace(input.workspace, []);
+    if (!input.projectDirectory)
+        return resolveWorkspace(input.workspace, fallback);
+    const detected = await detectWorkspaceType(input.projectDirectory, { maxDepth: 5 });
+    return detected.projectTypes.length > 0 ? detected.projectTypes : 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.

package/dist/tools/index.d.ts

@@ -3,14 +3,14 @@
  *
  * This module exports all available tools and utilities.
  * Tools use the @salesforce/b2c-tooling-sdk operations layer directly.
- * Use `--allow-non-ga-tools` flag to enable tools (preview release).
  *
  * @module tools
  */
 export * from './adapter.js';
 export * from './cartridges/index.js';
+export * from './cip/index.js';
 export * from './diagnostics/index.js';
 export * from './docs/index.js';
 export * from './mrt/index.js';
-export * from './pwav3/index.js';
 export * from './scapi/index.js';
+export * from './webdav/index.js';

package/dist/tools/index.js

@@ -8,7 +8,6 @@
  *
  * This module exports all available tools and utilities.
  * Tools use the @salesforce/b2c-tooling-sdk operations layer directly.
- * Use `--allow-non-ga-tools` flag to enable tools (preview release).
  *
  * @module tools
  */
@@ -16,9 +15,10 @@
 export * from './adapter.js';
 // Toolset exports
 export * from './cartridges/index.js';
+export * from './cip/index.js';
 export * from './diagnostics/index.js';
 export * from './docs/index.js';
 export * from './mrt/index.js';
-export * from './pwav3/index.js';
 export * from './scapi/index.js';
+export * from './webdav/index.js';
 //# sourceMappingURL=index.js.map

package/dist/tools/mrt/index.js

@@ -122,9 +122,11 @@ function createMrtBundlePushTool(loadServices, injections) {
     const detectWorkspaceTypeFn = injections?.detectWorkspaceType ?? detectWorkspaceType;
     return createToolAdapter({
         name: 'mrt_bundle_push',
+        effect: 'write',
+        idempotent: false,
+        openWorld: true,
         description: 'Bundle a pre-built PWA Kit or Storefront Next project and push to Managed Runtime. Optionally deploy to a target environment.',
         toolsets: ['MRT', 'PWAV3', 'STOREFRONTNEXT'],
-        isGA: true,
         // MRT operations use ApiKeyStrategy from MRT_API_KEY or ~/.mobify
         requiresMrtAuth: true,
         usesProjectContext: true,

package/dist/tools/project-context.d.ts

@@ -36,7 +36,7 @@ export interface ToolResolution {
 /** Whether a tool needs only a project root or full configuration selection. */
 export type ProjectContextKind = 'configuration' | 'project';
 /** Build the canonical project-directory field. */
-export declare function createProjectDirectoryInput(): z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+export declare function createProjectDirectoryInput(): z.ZodOptional<z.ZodString>;
 /** Build the canonical explicit primary dw.json field. */
 export declare function createConfigPathInput(): z.ZodOptional<z.ZodString>;
 /** Build the canonical named-instance selection field. */
@@ -44,6 +44,8 @@ export declare function createInstanceNameInput(): z.ZodOptional<z.ZodString>;
 /** Build flat canonical schema fields for a local-project or configuration-aware tool. */
 export declare function createProjectContextInputSchema(kind: ProjectContextKind): ZodRawShape;
 /** Static field for schemas declared outside the shared adapter. */
-export declare const projectDirectoryInput: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+export declare const projectDirectoryInput: z.ZodOptional<z.ZodString>;
 /** Static configuration schema for legacy/manual tool definitions. */
-export declare const projectContextInputSchema: z.ZodRawShape;
+export declare const projectContextInputSchema: Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>;

package/dist/tools/project-context.js

@@ -11,7 +11,7 @@ export function createProjectDirectoryInput() {
         .string()
         .refine((value) => path.isAbsolute(value), 'projectDirectory must be an absolute path')
         .optional()
-        .describe('Absolute project root; overrides server default. See config_inspect for resolved paths.');
+        .describe('Absolute project root; overrides the server default.');
 }
 /** Build the canonical explicit primary dw.json field. */
 export function createConfigPathInput() {

package/dist/tools/scapi/index.d.ts

@@ -2,7 +2,7 @@
  * SCAPI toolset for B2C Commerce.
  *
  * This toolset provides MCP tools for Salesforce Commerce API (SCAPI) discovery and exploration.
- * Includes standard SCAPI schemas, custom API status, and custom API scaffold tools.
+ * Includes standard SCAPI schemas, custom API status, and observability metrics.
  *
  * @module tools/scapi
  */

package/dist/tools/scapi/index.js

@@ -4,9 +4,9 @@
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
 import { createMetricsGetTool } from './metrics-get.js';
-import { createScaffoldCustomApiTool } from './scapi-custom-api-generate-scaffold.js';
 import { createScapiCustomApisStatusTool } from './scapi-custom-apis-get-status.js';
 import { createScapiSchemasListTool } from './scapi-schemas-list.js';
+import { createScapiCodeTools } from './scapi-code.js';
 /**
  * Creates all tools for the SCAPI toolset.
  *
@@ -15,8 +15,8 @@ import { createScapiSchemasListTool } from './scapi-schemas-list.js';
  */
 export function createScapiTools(loadServices) {
     return [
+        ...createScapiCodeTools(loadServices),
         createMetricsGetTool(loadServices),
-        createScaffoldCustomApiTool(loadServices),
         createScapiCustomApisStatusTool(loadServices),
         createScapiSchemasListTool(loadServices),
     ];

package/dist/tools/scapi/metrics-get.js

@@ -40,10 +40,12 @@ import { getMetricsByCategory, resolveMetricsWindow, enrichMetricsTags, } from '
 export function createMetricsGetTool(loadServices) {
     return createToolAdapter({
         name: 'metrics_get',
+        effect: 'read',
+        idempotent: true,
+        openWorld: true,
         description: 'CLOSED BETA. Retrieve B2C observability metric time series by category and time range. ' +
             'Defaults to the last 24 hours. Requires Metrics API access and OAuth scope sfcc.metrics.',
         toolsets: ['SCAPI'],
-        isGA: false,
         requiresInstance: false, // SCAPI uses OAuth directly
         usesConfigurationContext: true,
         inputSchema: {

package/dist/tools/scapi/scapi-code.d.ts

@@ -0,0 +1,3 @@
+import type { McpTool } from '../../utils/types.js';
+import type { ServicesLoader } from '../adapter.js';
+export declare function createScapiCodeTools(loadServices: ServicesLoader, snippetDirectory?: string): McpTool[];