@fluentcommerce/fluent-mcp-extn 0.7.0 → 0.7.2

package/dist/batch-tools.js

@@ -2,11 +2,11 @@
  * Batch Ingestion Tools
  *
  * Five batch lifecycle tools:
- *   batch.create      — create a batch ingestion job
- *   batch.send        — send records to an existing job
- *   batch.status      — check overall job status
- *   batch.batchStatus — check a specific batch inside a job
- *   batch.results     — get per-record outcomes for a completed job
+ *   batch_create      — create a batch ingestion job
+ *   batch_send        — send records to an existing job
+ *   batch_status      — check overall job status
+ *   batch_batchStatus — check a specific batch inside a job
+ *   batch_results     — get per-record outcomes for a completed job
  */
 import { z } from "zod";
 import { ToolError } from "./errors.js";
@@ -50,8 +50,8 @@ export const BatchDescribePayloadInputSchema = z.object({
 // ---------------------------------------------------------------------------
 export const BATCH_TOOL_DEFINITIONS = [
     {
-        name: "batch.create",
-        description: "Create a batch ingestion job. Next: batch.send -> batch.status -> batch.results.",
+        name: "batch_create",
+        description: "Create a batch ingestion job. Next: batch_send -> batch_status -> batch_results.",
         annotations: {
             title: "Create Batch Job",
             readOnlyHint: false,
@@ -61,8 +61,8 @@ export const BATCH_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "batch.send",
-        description: "Send records to an existing batch job. Requires jobId from batch.create.",
+        name: "batch_send",
+        description: "Send records to an existing batch job. Requires jobId from batch_create.",
         annotations: {
             title: "Send Batch",
             readOnlyHint: false,
@@ -72,7 +72,7 @@ export const BATCH_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "batch.status",
+        name: "batch_status",
         description: "Check overall job status for polling loops. Repeat until terminal status.",
         annotations: {
             title: "Batch Job Status",
@@ -83,7 +83,7 @@ export const BATCH_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "batch.batchStatus",
+        name: "batch_batchStatus",
         description: "Check a specific batch inside a job (jobId + batchId). Use for troubleshooting partial failures.",
         annotations: {
             title: "Batch Status",
@@ -94,7 +94,7 @@ export const BATCH_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "batch.results",
+        name: "batch_results",
         description: "Get per-record batch outcomes for a completed job.",
         annotations: {
             title: "Batch Results",
@@ -105,8 +105,8 @@ export const BATCH_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "batch.describePayload",
-        description: "Returns entity-type-specific payload shape, field requirements, and example rows for batch.send. No API call.",
+        name: "batch_describePayload",
+        description: "Returns entity-type-specific payload shape, field requirements, and example rows for batch_send. No API call.",
         annotations: {
             title: "Describe Batch Payload",
             readOnlyHint: true,
@@ -121,7 +121,7 @@ export const BATCH_TOOL_DEFINITIONS = [
 // ---------------------------------------------------------------------------
 function requireClient(ctx) {
     if (!ctx.client) {
-        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config.validate and fix auth/base URL.");
+        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config_validate and fix auth/base URL.");
     }
     return ctx.client;
 }
@@ -221,7 +221,7 @@ const BATCH_PAYLOAD_DESCRIPTORS = {
 // Handlers
 // ---------------------------------------------------------------------------
 /**
- * Handle batch.create tool call.
+ * Handle batch_create tool call.
  */
 export async function handleBatchCreate(args, ctx) {
     const client = requireClient(ctx);
@@ -243,7 +243,7 @@ export async function handleBatchCreate(args, ctx) {
     return { ok: true, job: result };
 }
 /**
- * Handle batch.send tool call.
+ * Handle batch_send tool call.
  */
 export async function handleBatchSend(args, ctx) {
     const client = requireClient(ctx);
@@ -254,7 +254,7 @@ export async function handleBatchSend(args, ctx) {
     return { ok: true, batch: result };
 }
 /**
- * Handle batch.status tool call.
+ * Handle batch_status tool call.
  */
 export async function handleBatchStatus(args, ctx) {
     const client = requireClient(ctx);
@@ -263,7 +263,7 @@ export async function handleBatchStatus(args, ctx) {
     return { ok: true, status: result };
 }
 /**
- * Handle batch.batchStatus tool call.
+ * Handle batch_batchStatus tool call.
  */
 export async function handleBatchBatchStatus(args, ctx) {
     const client = requireClient(ctx);
@@ -272,7 +272,7 @@ export async function handleBatchBatchStatus(args, ctx) {
     return { ok: true, batchStatus: result };
 }
 /**
- * Handle batch.results tool call.
+ * Handle batch_results tool call.
  */
 export async function handleBatchResults(args, ctx) {
     const client = requireClient(ctx);
@@ -281,7 +281,7 @@ export async function handleBatchResults(args, ctx) {
     return { ok: true, results: result };
 }
 /**
- * Handle batch.describePayload tool call.
+ * Handle batch_describePayload tool call.
  */
 export async function handleBatchDescribePayload(args, _ctx) {
     const parsed = BatchDescribePayloadInputSchema.parse(args);

package/dist/cache-tools.js

@@ -1,5 +1,5 @@
 /**
- * Cache management tools: cache.status and cache.clear.
+ * Cache management tools: cache_status and cache_clear.
  * No API calls — operates on local filesystem cache only.
  */
 import { z } from "zod";
@@ -13,14 +13,14 @@ export const CacheClearInputSchema = z.object({
     pattern: z
         .string()
         .optional()
-        .describe('Glob pattern to clear. Omit to clear all. Examples: "workflow:*", "setting:get:fc.mystique.*", "introspect:*".'),
+        .describe('Glob pattern to clear. Omit to clear all. Examples: "workflow:get:*", "workflow:list:*", "setting:get:fc.mystique.*", "plugin:list:*", "introspect:*".'),
 });
 // ---------------------------------------------------------------------------
 // Tool definitions
 // ---------------------------------------------------------------------------
 export const CACHE_TOOL_DEFINITIONS = [
     {
-        name: "cache.status",
+        name: "cache_status",
         description: "Local cache statistics: entry count, size, hit/miss rate, per-category breakdown.",
         annotations: {
             title: "Cache Status",
@@ -31,8 +31,8 @@ export const CACHE_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "cache.clear",
-        description: "Clear cached entries by pattern (e.g. workflow:*, setting:get:*, introspect:*) or all.",
+        name: "cache_clear",
+        description: "Clear cached entries by pattern (e.g. workflow:get:*, workflow:list:*, setting:get:*, plugin:list:*, introspect:*) or all.",
         annotations: {
             title: "Clear Cache",
             readOnlyHint: false,

package/dist/config.js

@@ -345,7 +345,7 @@ export function loadConfigForProfile(profileName, retailer, base) {
 }
 /**
  * Build a RuntimeConfig from explicit credentials (not a CLI profile).
- * Used by connection.add when the caller provides baseUrl + OAuth/token.
+ * Used by connection_add when the caller provides baseUrl + OAuth/token.
  */
 export function buildExplicitConfig(params, base) {
     return {

package/dist/entity-tools.js

@@ -1,5 +1,5 @@
 /**
- * Entity lifecycle tools: entity.create, entity.update, entity.get
+ * Entity lifecycle tools: entity_create, entity_update, entity_get
  *
  * Type-safe entity CRUD with built-in validation, gotcha knowledge,
  * and audit trail for agentic workflows.
@@ -63,7 +63,7 @@ export const EntityPlanUpdateInputSchema = z.object({
 // ---------------------------------------------------------------------------
 export const ENTITY_TOOL_DEFINITIONS = [
     {
-        name: "entity.create",
+        name: "entity_create",
         description: `Type-safe entity creation with field validation, compound key encoding, and retailerId auto-resolve. Supports dryRun. Types: ${SUPPORTED_ENTITY_TYPES.join(", ")}`,
         annotations: {
             title: "Create Entity",
@@ -74,8 +74,8 @@ export const ENTITY_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "entity.update",
-        description: "Update entity fields/status. Optional validateTransition checks workflow.transitions before status change.",
+        name: "entity_update",
+        description: "Update entity fields/status. Optional validateTransition checks workflow_transitions before status change.",
         annotations: {
             title: "Update Entity",
             readOnlyHint: false,
@@ -85,7 +85,7 @@ export const ENTITY_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "entity.get",
+        name: "entity_get",
         description: "Look up an entity by ID or ref. Use includeEdges to fetch related entities.",
         annotations: {
             title: "Get Entity",
@@ -96,7 +96,7 @@ export const ENTITY_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "entity.planCreate",
+        name: "entity_planCreate",
         description: `Plan an entity creation. Returns required fields, variables skeleton, GraphQL mutation, gotchas, and auto-inject info. No API call. Types: ${SUPPORTED_ENTITY_TYPES.join(", ")}.`,
         annotations: {
             title: "Plan Entity Create",
@@ -107,8 +107,8 @@ export const ENTITY_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "entity.planUpdate",
-        description: `Plan an entity update. Returns updatable fields, variables skeleton, GraphQL mutation, gotchas, and status-change guidance. No API call. Types: ${SUPPORTED_ENTITY_TYPES.join(", ")}.`,
+        name: "entity_planUpdate",
+        description: `Plan an entity_update. Returns updatable fields, variables skeleton, GraphQL mutation, gotchas, and status-change guidance. No API call. Types: ${SUPPORTED_ENTITY_TYPES.join(", ")}.`,
         annotations: {
             title: "Plan Entity Update",
             readOnlyHint: true,
@@ -120,7 +120,7 @@ export const ENTITY_TOOL_DEFINITIONS = [
 ];
 function requireEntityClient(ctx) {
     if (!ctx.client) {
-        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config.validate and fix auth/base URL.");
+        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config_validate and fix auth/base URL.");
     }
     return ctx.client;
 }
@@ -178,7 +178,7 @@ function optionalPlanFields(meta) {
     return Array.from(base);
 }
 /**
- * Handle entity.create tool call.
+ * Handle entity_create tool call.
  */
 export async function handleEntityCreate(args, ctx) {
     const parsed = EntityCreateInputSchema.parse(args);
@@ -245,7 +245,7 @@ export async function handleEntityCreate(args, ctx) {
     };
 }
 /**
- * Handle entity.update tool call.
+ * Handle entity_update tool call.
  */
 export async function handleEntityUpdate(args, ctx) {
     const parsed = EntityUpdateInputSchema.parse(args);
@@ -326,7 +326,7 @@ export async function handleEntityUpdate(args, ctx) {
     };
 }
 /**
- * Handle entity.get tool call.
+ * Handle entity_get tool call.
  */
 export async function handleEntityGet(args, ctx) {
     const parsed = EntityGetInputSchema.parse(args);
@@ -399,7 +399,7 @@ export async function handleEntityGet(args, ctx) {
     };
 }
 /**
- * Handle entity.planCreate tool call.
+ * Handle entity_planCreate tool call.
  */
 export function handleEntityPlanCreate(args, ctx) {
     const parsed = EntityPlanCreateInputSchema.parse(args);
@@ -454,7 +454,7 @@ export function handleEntityPlanCreate(args, ctx) {
     };
 }
 /**
- * Handle entity.planUpdate tool call.
+ * Handle entity_planUpdate tool call.
  */
 export function handleEntityPlanUpdate(args, _ctx) {
     const parsed = EntityPlanUpdateInputSchema.parse(args);
@@ -498,8 +498,8 @@ export function handleEntityPlanUpdate(args, _ctx) {
             hasRef: meta.hasRef,
         },
         _hints: [
-            "Required input field: id (ID!). Add status, attributes, and any other changed fields before calling entity.update.",
-            "Use entity.update for direct mutations. When changing status, validateTransition can warn when no workflow transition exists from the current state.",
+            "Required input field: id (ID!). Add status, attributes, and any other changed fields before calling entity_update.",
+            "Use entity_update for direct mutations. When changing status, validateTransition can warn when no workflow transition exists from the current state.",
         ],
     };
 }

package/dist/environment-tools.js

@@ -1,5 +1,5 @@
 /**
- * Environment tools: environment.discover, environment.validate
+ * Environment tools: environment_discover, environment_validate
  *
  * Closes the setup loop — single-call environment snapshot and pre-flight checks
  * for agentic workflows that need to understand what they're working with.
@@ -44,7 +44,7 @@ export const EnvironmentValidateInputSchema = z.object({
 // ---------------------------------------------------------------------------
 export const ENVIRONMENT_TOOL_DEFINITIONS = [
     {
-        name: "environment.discover",
+        name: "environment_discover",
         description: [
             "Full environment snapshot. Sections opt-in via include array: retailer, locations, networks, catalogues, workflows, settings, modules, users.",
             "Returns refs, IDs, statuses — enough to construct valid mutations. First 100 items per section.",
@@ -58,7 +58,7 @@ export const ENVIRONMENT_TOOL_DEFINITIONS = [
         },
     },
     {
-        name: "environment.validate",
+        name: "environment_validate",
         description: "Pre-flight validation checks: auth, retailer, locations, inventory, workflows, settings, modules. Returns pass/fail per check with severity.",
         annotations: {
             title: "Validate Environment",
@@ -123,7 +123,7 @@ const QUERIES = {
 };
 function requireEnvClient(ctx) {
     if (!ctx.client) {
-        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config.validate and fix auth/base URL.");
+        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config_validate and fix auth/base URL.");
     }
     return ctx.client;
 }
@@ -152,7 +152,7 @@ function extractNodes(connection) {
         .filter((n) => n !== null);
 }
 /**
- * Handle environment.discover tool call.
+ * Handle environment_discover tool call.
  */
 export async function handleEnvironmentDiscover(args, ctx) {
     const parsed = EnvironmentDiscoverInputSchema.parse(args);
@@ -187,7 +187,7 @@ export async function handleEnvironmentDiscover(args, ctx) {
                     const locPageInfo = data.locations?.pageInfo;
                     result.locations = locationNodes;
                     if (locPageInfo?.hasNextPage) {
-                        result.locationsNote = `Showing first ${locationNodes.length} locations. Use graphql.queryAll for complete list.`;
+                        result.locationsNote = `Showing first ${locationNodes.length} locations. Use graphql_queryAll for complete list.`;
                     }
                     break;
                 }
@@ -211,7 +211,7 @@ export async function handleEnvironmentDiscover(args, ctx) {
                 }
                 case "workflows": {
                     // Workflows are not directly queryable via standard GraphQL.
-                    // We use the workflow.transitions API to discover deployed workflow types.
+                    // We use the workflow_transitions API to discover deployed workflow types.
                     const retailerId = ctx.config.retailerId;
                     if (retailerId) {
                         try {
@@ -259,12 +259,12 @@ export async function handleEnvironmentDiscover(args, ctx) {
                     const settPageInfo = data.settings?.pageInfo;
                     result.settings = settingNodes;
                     if (settPageInfo?.hasNextPage) {
-                        result.settingsNote = `Showing first ${settingNodes.length} settings. Use graphql.queryAll for complete list.`;
+                        result.settingsNote = `Showing first ${settingNodes.length} settings. Use graphql_queryAll for complete list.`;
                     }
                     break;
                 }
                 case "modules": {
-                    // Modules discoverable via plugin.list
+                    // Modules discoverable via plugin_list
                     try {
                         const plugins = await client.getPlugins();
                         if (plugins && typeof plugins === "object") {
@@ -305,7 +305,7 @@ export async function handleEnvironmentDiscover(args, ctx) {
     return { ok: true, ...result };
 }
 /**
- * Handle environment.validate tool call.
+ * Handle environment_validate tool call.
  */
 export async function handleEnvironmentValidate(args, ctx) {
     const parsed = EnvironmentValidateInputSchema.parse(args);

package/dist/event-tools.js

@@ -1,5 +1,5 @@
 /**
- * Event lifecycle tools: event.build, event.send, event.get, event.list, event.flowInspect
+ * Event lifecycle tools: event_build, event_send, event_get, event_list, event_flowInspect
  *
  * Extracted from tools.ts — follows the same pattern as entity-tools.ts.
  */
@@ -46,7 +46,7 @@ export const EventPublishInputSchema = z.object({
 export const EventGetInputSchema = z.object({
     eventId: z.string().min(1),
 });
-/** Tool input for event.list. Supports canonical keys and backward-compatible aliases. */
+/** Tool input for event_list. Supports canonical keys and backward-compatible aliases. */
 export const EventListInputSchema = z
     .object({
     // Canonical keys (SDK FluentEventQueryParams)
@@ -113,31 +113,31 @@ export const EventFlowInspectInputSchema = z.object({
 // ---------------------------------------------------------------------------
 export const EVENT_TOOL_DEFINITIONS = [
     {
-        name: "event.build",
-        description: "Payload-only builder for Event API input. Use before event.send to verify defaults and required context (no API call).",
+        name: "event_build",
+        description: "Payload-only builder for Event API input. Use before event_send to verify defaults and required context (no API call).",
         schema: EventBuildInputSchema,
         annotations: { title: "Build Event Payload", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     },
     {
-        name: "event.send",
-        description: "Builds and sends a Fluent event (supports dryRun). dryRun=true includes _workflowPreview with matching rulesets, predicted target status, and rule analysis when workflow is cached. Call workflow.get first for full preview.",
+        name: "event_send",
+        description: "Builds and sends a Fluent event (supports dryRun). dryRun=true includes _workflowPreview with matching rulesets, predicted target status, and rule analysis when workflow is cached. Call workflow_get first for full preview.",
         schema: EventPublishInputSchema,
         annotations: { title: "Send Event", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
     },
     {
-        name: "event.get",
-        description: "Fetch one event by ID. Use after event.send if response contains eventId, or after event.list resolves eventId.",
+        name: "event_get",
+        description: "Fetch one event by ID. Use after event_send if response contains eventId, or after event_list resolves eventId.",
         schema: EventGetInputSchema,
         annotations: { title: "Get Event", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     },
     {
-        name: "event.list",
-        description: "List/filter events via SDK getEvents with filters and pagination. Use to verify sends, discover eventId, then call event.get for full details.",
+        name: "event_list",
+        description: "List/filter events via SDK getEvents with filters and pagination. Use to verify sends, discover eventId, then call event_get for full details.",
         schema: EventListInputSchema,
         annotations: { title: "List Events", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     },
     {
-        name: "event.flowInspect",
+        name: "event_flowInspect",
         description: "One-call event forensics for a root entity. Collects ORCHESTRATION events, extracts timelines, mutations, webhooks, NO_MATCH diagnostics. Compact mode (default) returns pre-analyzed summary.",
         schema: EventFlowInspectInputSchema,
         annotations: { title: "Inspect Event Flow", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
@@ -145,7 +145,7 @@ export const EVENT_TOOL_DEFINITIONS = [
 ];
 function requireEventClient(ctx) {
     if (!ctx.client) {
-        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config.validate and fix auth/base URL.");
+        throw new ToolError("CONFIG_ERROR", "SDK client is not available. Run config_validate and fix auth/base URL.");
     }
     return ctx.client;
 }
@@ -255,7 +255,7 @@ export function toEventQueryParams(input) {
 // Handlers
 // ---------------------------------------------------------------------------
 /**
- * Handle event.build tool call.
+ * Handle event_build tool call.
  */
 export async function handleEventBuild(args, ctx) {
     const parsed = EventBuildInputSchema.parse(args);
@@ -268,14 +268,14 @@ export async function handleEventBuild(args, ctx) {
 export function buildEventDryRunEnrichment(eventName, entityType, entitySubtype, cache, retailerId) {
     const hints = [];
     if (!cache || !retailerId) {
-        hints.push("Call workflow.get with entityType + entitySubtype to enable workflow simulation preview in dryRun.");
+        hints.push("Call workflow_get with entityType + entitySubtype to enable workflow simulation preview in dryRun.");
         return { _hints: hints };
     }
     const subtype = entitySubtype ?? "DEFAULT";
     const cacheKey = `workflow:get:${retailerId}:${entityType}::${subtype}:latest`;
     const cached = cache.get(cacheKey);
     if (!cached.hit || !cached.data || typeof cached.data !== "object") {
-        hints.push(`No cached workflow for ${entityType}::${subtype}. Call workflow.get first to enable simulation preview.`);
+        hints.push(`No cached workflow for ${entityType}::${subtype}. Call workflow_get first to enable simulation preview.`);
         return { _hints: hints };
     }
     const wf = cached.data;
@@ -346,7 +346,7 @@ export function buildEventDryRunEnrichment(eventName, entityType, entitySubtype,
         });
     }
     if (matchingRulesets.length === 0) {
-        hints.push(`No ruleset named "${eventName}" found in workflow ${entityType}::${subtype}. The event may trigger by entity status match instead. Use workflow.simulate for full analysis.`);
+        hints.push(`No ruleset named "${eventName}" found in workflow ${entityType}::${subtype}. The event may trigger by entity status match instead. Use workflow_simulate for full analysis.`);
         return { _hints: hints };
     }
     // Deduplicated aggregates
@@ -371,7 +371,7 @@ export function buildEventDryRunEnrichment(eventName, entityType, entitySubtype,
     if (uniqueFollowOnEvents.length > 0) {
         hints.push(`Follow-on event(s) will be emitted: ${uniqueFollowOnEvents.join(", ")}.`);
     }
-    hints.push("Use event.flowInspect after sending to verify execution results.");
+    hints.push("Use event_flowInspect after sending to verify execution results.");
     return {
         _workflowPreview: {
             workflowName: wf.name ?? `${entityType}::${subtype}`,
@@ -388,7 +388,7 @@ export function buildEventDryRunEnrichment(eventName, entityType, entitySubtype,
     };
 }
 /**
- * Handle event.send tool call.
+ * Handle event_send tool call.
  */
 export async function handleEventSend(args, ctx) {
     const parsed = EventPublishInputSchema.parse(args);
@@ -406,7 +406,7 @@ export async function handleEventSend(args, ctx) {
                 : {}),
             _hints: [
                 ...enrichment._hints,
-                "Use workflow.simulate with currentStatus + eventName for full static analysis.",
+                "Use workflow_simulate with currentStatus + eventName for full static analysis.",
             ],
         };
     }
@@ -419,17 +419,17 @@ export async function handleEventSend(args, ctx) {
         _hints: parsed.mode === "async"
             ? [
                 "Event sent asynchronously. Processing happens in the background.",
-                "Use event.list with context.entityRef + name to find the event and check eventStatus.",
-                "Use event.flowInspect with rootEntityRef for full execution forensics.",
+                "Use event_list with context.entityRef + name to find the event and check eventStatus.",
+                "Use event_flowInspect with rootEntityRef for full execution forensics.",
             ]
             : [
-                "Use event.get with the returned eventId to check detailed status.",
-                "Use event.flowInspect with rootEntityRef for full execution forensics.",
+                "Use event_get with the returned eventId to check detailed status.",
+                "Use event_flowInspect with rootEntityRef for full execution forensics.",
             ],
     };
 }
 /**
- * Handle event.get tool call.
+ * Handle event_get tool call.
  */
 export async function handleEventGet(args, ctx) {
     const parsed = EventGetInputSchema.parse(args);
@@ -438,7 +438,7 @@ export async function handleEventGet(args, ctx) {
     return { ok: true, event };
 }
 /**
- * Handle event.list tool call.
+ * Handle event_list tool call.
  */
 export async function handleEventList(args, ctx) {
     const parsed = EventListInputSchema.parse(args);
@@ -476,7 +476,7 @@ export async function handleEventList(args, ctx) {
     return { ok: true, events };
 }
 /**
- * Handle event.flowInspect tool call.
+ * Handle event_flowInspect tool call.
  */
 export async function handleEventFlowInspect(args, ctx) {
     const parsed = EventFlowInspectInputSchema.parse(args);

package/dist/fluent-client.js

@@ -170,6 +170,26 @@ export class FluentClientAdapter {
             return FluentClientAdapter.unwrapResponse(response);
         });
     }
+    /**
+     * Upload (deploy) a workflow JSON to the Fluent environment.
+     * PUT /api/v4.1/workflow/{retailerId}
+     * Uses PUT for idempotent upsert — replaces the workflow definition
+     * rather than creating a new version on every call (which POST does).
+     * Write operation — executeOnce (timeout, no retry).
+     *
+     * NOTE: This does NOT update the CLI workflowlog cache.
+     */
+    async uploadWorkflow(retailerId, workflow) {
+        const requestClient = this.requireRequestClient("Workflow REST upload API");
+        return this.executeOnce("uploadWorkflow", async () => {
+            const response = await requestClient.request(`/api/v4.1/workflow/${retailerId}`, {
+                method: "PUT",
+                headers: { "Content-Type": "application/json" },
+                body: workflow,
+            });
+            return FluentClientAdapter.unwrapResponse(response);
+        });
+    }
     /**
      * Query Prometheus metrics via GraphQL metricInstant / metricRange queries.
      * The Fluent platform does NOT expose raw Prometheus REST endpoints