@fluentcommerce/fluent-mcp-extn 0.2.1 → 0.3.1

package/dist/tools.js

@@ -6,8 +6,8 @@ import { buildEventPayload } from "./event-payload.js";
 import { ToolError, toToolFailure } from "./errors.js";
 // New tool modules
 import { ENTITY_TOOL_DEFINITIONS, handleEntityCreate, handleEntityUpdate, handleEntityGet, } from "./entity-tools.js";
-import { WORKFLOW_TOOL_DEFINITIONS, handleWorkflowUpload, handleWorkflowDiff, handleWorkflowSimulate, } from "./workflow-tools.js";
-import { SETTING_TOOL_DEFINITIONS, handleSettingUpsert, handleSettingBulkUpsert, } from "./settings-tools.js";
+import { WORKFLOW_TOOL_DEFINITIONS, handleWorkflowGet, handleWorkflowList, handleWorkflowUpload, handleWorkflowDiff, handleWorkflowSimulate, } from "./workflow-tools.js";
+import { SETTING_TOOL_DEFINITIONS, handleSettingGet, handleSettingUpsert, handleSettingBulkUpsert, } from "./settings-tools.js";
 import { ENVIRONMENT_TOOL_DEFINITIONS, handleEnvironmentDiscover, handleEnvironmentValidate, } from "./environment-tools.js";
 import { TEST_TOOL_DEFINITIONS, handleTestAssert, } from "./test-tools.js";
 import { shapeResponse, summarizeConnection, analyzeEvents, } from "./response-shaper.js";
@@ -128,6 +128,8 @@ const TransitionTriggerInputSchema = z.object({
     module: z.string().min(1).optional(),
     flexType: z.string().min(1).optional(),
     flexVersion: z.union([z.string().min(1), z.number().int()]).optional(),
+    entityId: z.string().min(1).optional(),
+    entityRef: z.string().min(1).optional(),
 });
 const TransitionActionsInputSchema = z.object({
     triggers: z.array(TransitionTriggerInputSchema).min(1),
@@ -599,8 +601,16 @@ const TOOL_DEFINITIONS = [
             "INTEGRATION: The eventName from each userAction maps directly to event.send's \"name\" parameter.",
             "The attributes[] tell you what to include in event.send's \"attributes\" parameter.",
             "",
+            "CRITICAL: The Transition API requires `flexType` (e.g. ORDER::HD) to return results.",
+            "Without it the API silently returns empty `{response:[]}`. For some entity types",
+            "(e.g. CREDIT_MEMO) `flexVersion` is also required. When `type` and `subtype` are",
+            "provided but `flexType` is not, the tool auto-derives it as `TYPE::SUBTYPE`.",
+            "",
+            "BEST PRACTICE: Always provide `flexType` and `flexVersion` for reliable results.",
+            "Get these from the entity's `workflowRef` and `workflowVersion` fields via GraphQL.",
+            "",
             "EXAMPLE: Find available actions for an ORDER in CREATED status:",
-            "{ triggers: [{ type: \"ORDER\", subtype: \"HD\", status: \"CREATED\", retailerId: \"5\", flexType: \"ORDER::HD\" }] }",
+            "{ triggers: [{ type: \"ORDER\", subtype: \"HD\", status: \"CREATED\", retailerId: \"5\", flexType: \"ORDER::HD\", flexVersion: 4 }] }",
         ].join("\n"),
         inputSchema: {
             type: "object",
@@ -623,17 +633,19 @@ const TOOL_DEFINITIONS = [
                             },
                             module: {
                                 type: "string",
-                                description: "Filter by module (e.g. servicepoint, adminconsole). Case-sensitive.",
+                                description: "REQUIRED for results. App module name (e.g. adminconsole, oms, store, servicepoint). Without this, API silently returns empty userActions. Case-sensitive.",
                             },
                             flexType: {
                                 type: "string",
-                                description: "Workflow type (e.g. ORDER::HD, FULFILMENT::HD_WH).",
+                                description: "Workflow type (e.g. ORDER::HD, FULFILMENT::HD_WH). REQUIRED for API to return results. Auto-derived from type::subtype when omitted.",
                             },
                             flexVersion: {
                                 oneOf: [{ type: "integer" }, { type: "string" }],
-                                description: "Workflow version. Omit for latest.",
+                                description: "Workflow version. Strongly recommended — required for some entity types (e.g. CREDIT_MEMO). Get from entity's workflowVersion field.",
                             },
                             name: { type: "string", description: "Event name filter" },
+                            entityId: { type: "string", description: "Entity ID (strongly recommended — API may return empty without it)" },
+                            entityRef: { type: "string", description: "Entity ref (strongly recommended — API may return empty without it)" },
                         },
                         required: ["retailerId"],
                         additionalProperties: false,
@@ -1258,7 +1270,14 @@ export function toEventQueryParams(input) {
     return params;
 }
 /**
- * Fill missing trigger.retailerId from runtime config and validate readiness.
+ * Fill missing trigger fields from runtime config and validate readiness.
+ *
+ * The Transition API requires `flexType` (e.g. "ORDER::HD") to return results.
+ * Without it the API silently returns `{"response":[]}`.  For some entity
+ * types (e.g. CREDIT_MEMO) `flexVersion` is also required.
+ *
+ * This function auto-derives `flexType` from `type`+`subtype` when both are
+ * present and `flexType` is not explicitly set.
  */
 export function resolveTransitionRequest(input, fallbackRetailerId) {
     const triggers = input.triggers.map((trigger, index) => {
@@ -1266,9 +1285,16 @@ export function resolveTransitionRequest(input, fallbackRetailerId) {
         if (!retailerId) {
             throw new ToolError("VALIDATION_ERROR", `triggers[${index}].retailerId is required. Set FLUENT_RETAILER_ID or pass retailerId per trigger.`);
         }
+        // Auto-derive flexType from type+subtype when not explicitly provided.
+        // The Transition API requires flexType to return user actions.
+        let flexType = trigger.flexType;
+        if (!flexType && trigger.type && trigger.subtype) {
+            flexType = `${trigger.type}::${trigger.subtype}`;
+        }
         return {
             ...trigger,
             retailerId,
+            ...(flexType ? { flexType } : {}),
         };
     });
     return { triggers };
@@ -3212,6 +3238,16 @@ export function registerToolHandlers(server, ctx) {
                 const result = await handleEntityGet(args, ctx);
                 return json(result, false, ctx.responseBudget);
             }
+            // ------- workflow.get ---------------------------------------------------
+            if (toolName === "workflow.get") {
+                const result = await handleWorkflowGet(args, ctx);
+                return json(result, false, ctx.responseBudget);
+            }
+            // ------- workflow.list --------------------------------------------------
+            if (toolName === "workflow.list") {
+                const result = await handleWorkflowList(args, ctx);
+                return json(result, false, ctx.responseBudget);
+            }
             // ------- workflow.upload -----------------------------------------------
             if (toolName === "workflow.upload") {
                 const result = await handleWorkflowUpload(args, ctx);
@@ -3227,6 +3263,11 @@ export function registerToolHandlers(server, ctx) {
                 const result = await handleWorkflowSimulate(args, ctx);
                 return json(result, false, ctx.responseBudget);
             }
+            // ------- setting.get ---------------------------------------------------
+            if (toolName === "setting.get") {
+                const result = await handleSettingGet(args, ctx);
+                return json(result, false, ctx.responseBudget);
+            }
             // ------- setting.upsert ------------------------------------------------
             if (toolName === "setting.upsert") {
                 const result = await handleSettingUpsert(args, ctx);

package/dist/workflow-tools.js

@@ -7,6 +7,8 @@
  * event outcomes without live execution.
  */
 import { z } from "zod";
+import * as fs from "node:fs";
+import * as path from "node:path";
 import { ToolError } from "./errors.js";
 // ---------------------------------------------------------------------------
 // Input schemas
@@ -40,6 +42,42 @@ export const WorkflowDiffInputSchema = z.object({
         .default("summary")
         .describe("Output format: summary (default), detailed, or mermaid"),
 });
+export const WorkflowGetInputSchema = z.object({
+    entityType: z
+        .string()
+        .describe("Workflow entity type (e.g., ORDER, FULFILMENT, INVENTORY_CATALOGUE, RETURN_ORDER, BILLING_ACCOUNT, VIRTUAL_CATALOGUE, PRODUCT_CATALOGUE, CONTROL_GROUP, PAYMENT, WAVE, CONSIGNMENT, ARTICLE)."),
+    entitySubtype: z
+        .string()
+        .describe("Workflow entity subtype (e.g., HD, DEFAULT, MASTER, BASE, CC, CUSTOMER, REFUND, PAYMENT)."),
+    retailerId: z
+        .string()
+        .optional()
+        .describe("Target retailer ID. Falls back to FLUENT_RETAILER_ID."),
+    version: z
+        .string()
+        .optional()
+        .describe("Specific workflow version to fetch. Omit for latest."),
+    outputFile: z
+        .string()
+        .optional()
+        .describe("Optional file path to save the full workflow JSON. " +
+        "When provided, writes workflow to file and returns only summary " +
+        "(name, version, status/ruleset counts) — keeps large workflow JSON out of the LLM context. " +
+        "Parent directories are created automatically."),
+});
+export const WorkflowListInputSchema = z.object({
+    retailerId: z
+        .string()
+        .optional()
+        .describe("Target retailer ID. Falls back to FLUENT_RETAILER_ID."),
+    outputDir: z
+        .string()
+        .optional()
+        .describe("Optional directory path to download ALL workflows (latest version each) as individual JSON files. " +
+        "Each file is named <ENTITY_TYPE>-<ENTITY_SUBTYPE>.json (e.g., ORDER-HD.json). " +
+        "Returns only summary metadata — full workflow JSON is NOT included in the response. " +
+        "Reads from live server (NOT workflowlog cache). Parent directories are created automatically."),
+});
 export const WorkflowSimulateInputSchema = z.object({
     workflow: z
         .union([z.string(), z.record(z.string(), z.unknown())])
@@ -64,6 +102,91 @@ export const WorkflowSimulateInputSchema = z.object({
 // Tool definitions (JSON Schema for MCP)
 // ---------------------------------------------------------------------------
 export const WORKFLOW_TOOL_DEFINITIONS = [
+    {
+        name: "workflow.get",
+        description: [
+            "Fetch a workflow definition by entity type and subtype from the Fluent REST API.",
+            "",
+            "Calls GET /api/v4.1/workflow/{retailerId}/{entityType}::{entitySubtype}/",
+            "Returns the full workflow JSON including statuses, rulesets, rules, and triggers.",
+            "",
+            "NOTE: This fetches a specific workflow by name, which works even when the list",
+            "endpoint returns 401 (insufficient permissions for listing).",
+            "",
+            "KNOWN ENTITY TYPES:",
+            "ORDER, FULFILMENT, INVENTORY_CATALOGUE, RETURN_ORDER, BILLING_ACCOUNT,",
+            "VIRTUAL_CATALOGUE, PRODUCT_CATALOGUE, CONTROL_GROUP, PAYMENT, WAVE,",
+            "CONSIGNMENT, ARTICLE, LOCATION, NETWORK, CUSTOMER, CREDIT_MEMO",
+            "",
+            "COMMON SUBTYPES:",
+            "HD, CC, DEFAULT, MASTER, BASE, CUSTOMER, REFUND, PAYMENT, HD_WH, HD_MP",
+            "",
+            "RESPONSE includes: name, version, entityType, entitySubtype, statuses, rulesets,",
+            "and a summary with status/ruleset/rule counts.",
+            "",
+            "Use outputFile to save large workflow JSON to disk instead of returning inline.",
+            "Returns only summary (name, version, counts) when outputFile is set.",
+        ].join("\n"),
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityType: {
+                    type: "string",
+                    description: "Workflow entity type (e.g., ORDER, FULFILMENT, INVENTORY_CATALOGUE)",
+                },
+                entitySubtype: {
+                    type: "string",
+                    description: "Workflow entity subtype (e.g., HD, DEFAULT, MASTER)",
+                },
+                retailerId: {
+                    type: "string",
+                    description: "Target retailer ID.",
+                },
+                version: {
+                    type: "string",
+                    description: "Specific workflow version. Omit for latest.",
+                },
+                outputFile: {
+                    type: "string",
+                    description: "File path to save workflow JSON. Returns summary only (not full JSON) when set.",
+                },
+            },
+            required: ["entityType", "entitySubtype"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "workflow.list",
+        description: [
+            "List all workflows for a retailer from the Fluent REST API.",
+            "",
+            "Calls GET /api/v4.1/workflow?retailerId={retailerId}",
+            "Returns a list of workflow summaries (name, version, entityType, entitySubtype, status).",
+            "",
+            "When outputDir is provided, downloads ALL workflows (latest version each) as individual",
+            "JSON files to the directory. Each file is named <TYPE>-<SUBTYPE>.json (e.g., ORDER-HD.json).",
+            "Returns only summary metadata — full JSON stays on disk, not in the response.",
+            "Reads from LIVE server, not the workflowlog cache.",
+            "",
+            "NOTE: This endpoint may return 401 on some accounts where the user lacks listing",
+            "permissions. In that case, use workflow.get to fetch a specific workflow by name.",
+        ].join("\n"),
+        inputSchema: {
+            type: "object",
+            properties: {
+                retailerId: {
+                    type: "string",
+                    description: "Target retailer ID.",
+                },
+                outputDir: {
+                    type: "string",
+                    description: "Directory to save all workflows as individual JSON files. Returns summary only when set.",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
     {
         name: "workflow.upload",
         description: [
@@ -750,3 +873,166 @@ export async function handleWorkflowSimulate(args, _ctx) {
         limitations,
     };
 }
+/**
+ * Handle workflow.get tool call.
+ * Fetches a specific workflow by entityType::entitySubtype via REST API.
+ */
+export async function handleWorkflowGet(args, ctx) {
+    const parsed = WorkflowGetInputSchema.parse(args);
+    const retailerId = parsed.retailerId ?? ctx.config.retailerId;
+    if (!retailerId) {
+        throw new ToolError("VALIDATION_ERROR", "retailerId is required. Set FLUENT_RETAILER_ID or pass retailerId.");
+    }
+    const client = requireWorkflowClient(ctx);
+    const workflowName = `${parsed.entityType}::${parsed.entitySubtype}`;
+    const response = await client.getWorkflow(retailerId, parsed.entityType, parsed.entitySubtype, parsed.version);
+    // Extract summary info from the workflow
+    const wf = response;
+    if (!wf || typeof wf !== "object") {
+        throw new ToolError("VALIDATION_ERROR", `No workflow found for ${workflowName} on retailer ${retailerId}.`);
+    }
+    const statuses = (wf.statuses ?? wf.subStatuses);
+    const rulesets = wf.rulesets;
+    const totalRules = (rulesets ?? []).reduce((sum, rs) => {
+        const rules = rs.rules;
+        return sum + (rules?.length ?? 0);
+    }, 0);
+    const summary = {
+        statuses: statuses?.length ?? 0,
+        rulesets: rulesets?.length ?? 0,
+        totalRules,
+    };
+    // If outputFile is provided, write workflow to file and return summary only
+    if (parsed.outputFile) {
+        const fileContent = JSON.stringify(wf, null, 2);
+        const dir = path.dirname(parsed.outputFile);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(parsed.outputFile, fileContent, "utf-8");
+        return {
+            ok: true,
+            workflowName: wf.name ?? workflowName,
+            version: wf.version,
+            entityType: wf.entityType ?? parsed.entityType,
+            entitySubtype: wf.entitySubtype ?? parsed.entitySubtype,
+            retailerId,
+            summary,
+            savedTo: parsed.outputFile,
+            sizeBytes: Buffer.byteLength(fileContent, "utf-8"),
+            message: `Workflow saved to ${parsed.outputFile} (${Buffer.byteLength(fileContent, "utf-8")} bytes). Full JSON NOT included in response.`,
+        };
+    }
+    return {
+        ok: true,
+        workflowName: wf.name ?? workflowName,
+        version: wf.version,
+        entityType: wf.entityType ?? parsed.entityType,
+        entitySubtype: wf.entitySubtype ?? parsed.entitySubtype,
+        retailerId,
+        summary,
+        workflow: wf,
+    };
+}
+/**
+ * Handle workflow.list tool call.
+ * Lists all workflows for a retailer via REST API.
+ */
+export async function handleWorkflowList(args, ctx) {
+    const parsed = WorkflowListInputSchema.parse(args);
+    const retailerId = parsed.retailerId ?? ctx.config.retailerId;
+    if (!retailerId) {
+        throw new ToolError("VALIDATION_ERROR", "retailerId is required. Set FLUENT_RETAILER_ID or pass retailerId.");
+    }
+    const client = requireWorkflowClient(ctx);
+    const response = await client.listWorkflows(retailerId);
+    // Response can be: bare array, paginated { results: [...] }, or unwrapped from { data: ... }
+    let workflows;
+    if (Array.isArray(response)) {
+        workflows = response;
+    }
+    else if (response && typeof response === "object" && "results" in response) {
+        workflows = response.results;
+    }
+    else {
+        workflows = [];
+    }
+    // Deduplicate: group by name, keep only latest version
+    const latestByName = new Map();
+    for (const wf of workflows) {
+        const w = wf;
+        const name = w.name;
+        if (!name)
+            continue;
+        const existing = latestByName.get(name);
+        if (!existing || Number(w.version) > Number(existing.version)) {
+            latestByName.set(name, w);
+        }
+    }
+    const latest = [...latestByName.values()].map((w) => ({
+        name: w.name,
+        version: w.version,
+        entityType: w.entityType,
+        entitySubtype: w.entitySubtype,
+        status: w.status,
+        createdOn: w.createdOn,
+    }));
+    // If outputDir is provided, download each workflow's full JSON to individual files
+    if (parsed.outputDir && latest.length > 0) {
+        fs.mkdirSync(parsed.outputDir, { recursive: true });
+        const savedFiles = [];
+        const errors = [];
+        for (const wf of latest) {
+            const entityType = wf.entityType;
+            const entitySubtype = wf.entitySubtype;
+            if (!entityType || !entitySubtype)
+                continue;
+            try {
+                const fullWf = await client.getWorkflow(retailerId, entityType, entitySubtype);
+                if (fullWf && typeof fullWf === "object") {
+                    const fileContent = JSON.stringify(fullWf, null, 2);
+                    const fileName = `${entityType}-${entitySubtype}.json`;
+                    const filePath = path.join(parsed.outputDir, fileName);
+                    fs.writeFileSync(filePath, fileContent, "utf-8");
+                    savedFiles.push({
+                        name: wf.name,
+                        file: filePath,
+                        sizeBytes: Buffer.byteLength(fileContent, "utf-8"),
+                        version: wf.version,
+                    });
+                }
+            }
+            catch (err) {
+                errors.push({
+                    name: `${entityType}::${entitySubtype}`,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        const totalBytes = savedFiles.reduce((s, f) => s + f.sizeBytes, 0);
+        return {
+            ok: true,
+            retailerId,
+            totalVersions: workflows.length,
+            uniqueWorkflows: latest.length,
+            savedTo: parsed.outputDir,
+            filesWritten: savedFiles.length,
+            totalSizeBytes: totalBytes,
+            files: savedFiles,
+            ...(errors.length > 0 ? { errors } : {}),
+            message: `${savedFiles.length} workflow(s) saved to ${parsed.outputDir}/ (${(totalBytes / 1024).toFixed(1)} KB total). ` +
+                `Full JSON NOT included in response.` +
+                (errors.length > 0
+                    ? ` ${errors.length} workflow(s) failed to download.`
+                    : ""),
+        };
+    }
+    return {
+        ok: true,
+        retailerId,
+        totalVersions: workflows.length,
+        uniqueWorkflows: latest.length,
+        workflows: latest,
+        note: workflows.length === 0
+            ? "No workflows found. The list endpoint may return 401 on some accounts — try workflow.get with a specific entityType and entitySubtype instead."
+            : undefined,
+    };
+}

package/docs/E2E_TESTING.md

@@ -235,8 +235,8 @@ Discovery-first single order lifecycle test. Creates an order with
 **How to run:**
 
 ```bash
-npx tsx scripts/e2e-full-order.ts --profile SAGIRISH --retailer 2
-FLUENT_PROFILE=SAGIRISH FLUENT_RETAILER_ID=2 npx tsx scripts/e2e-full-order.ts
+npx tsx scripts/e2e-full-order.ts --profile YOUR_PROFILE --retailer 2
+FLUENT_PROFILE=YOUR_PROFILE FLUENT_RETAILER_ID=2 npx tsx scripts/e2e-full-order.ts
 ```
 
 **Environment:** requires `FLUENT_PROFILE` + `FLUENT_RETAILER_ID`, or `--profile`
@@ -269,7 +269,7 @@ MULTI order type workflow and includes workflow transition discovery.
 npx tsx scripts/e2e-full-multi.ts
 ```
 
-**Environment:** defaults to `FLUENT_BASE_URL=https://sagirish.test.api.fluentretail.com`
+**Environment:** defaults to `FLUENT_BASE_URL=https://<account>.test.api.fluentretail.com`
 and `FLUENT_RETAILER_ID=2`. Override with env vars. Requires OAuth or profile
 credentials.
 
@@ -296,7 +296,7 @@ Comprehensive smoke test for all 11 agentic tools against a live environment.
 **How to run:**
 
 ```bash
-npx tsx scripts/e2e-agentic.ts --profile SAGIRISH
+npx tsx scripts/e2e-agentic.ts --profile YOUR_PROFILE
 ```
 
 **Environment:** requires `FLUENT_PROFILE` or `--profile` flag. Defaults to
@@ -322,7 +322,7 @@ responses.
 **How to run:**
 
 ```bash
-npx tsx scripts/e2e-response-shaping.ts --profile SAGIRISH
+npx tsx scripts/e2e-response-shaping.ts --profile YOUR_PROFILE
 ```
 
 **Environment:** requires `FLUENT_PROFILE` or `--profile`. Uses default budget
@@ -347,7 +347,7 @@ per-event drilldowns via `event.get`.
 **How to run:**
 
 ```bash
-npx tsx scripts/run-flow-inspect.ts <ROOT_ENTITY_REF> --profile SAGIRISH
+npx tsx scripts/run-flow-inspect.ts <ROOT_ENTITY_REF> --profile YOUR_PROFILE
 npx tsx scripts/run-flow-inspect.ts HD-001 --root-type ORDER --profile HMDEV
 npx tsx scripts/run-flow-inspect.ts HD-001 --root-id 12345 --light --no-drilldown
 npx tsx scripts/run-flow-inspect.ts HD-001 --drilldown-classes webhook,mutation --drilldown-limit 20
@@ -357,7 +357,7 @@ npx tsx scripts/run-flow-inspect.ts HD-001 --drilldown-classes webhook,mutation
 
 | Flag | Default | Description |
 |------|---------|-------------|
-| `--profile <name>` | `SAGIRISH` | Fluent CLI profile |
+| `--profile <name>` | - | Fluent CLI profile |
 | `--root-type <type>` | any | Root entity type (ORDER, FULFILMENT, etc.) |
 | `--root-id <id>` | - | Root entity ID for disambiguation |
 | `--out <path>` | `accounts/<profile>/analysis/EVENT_FLOW_INSPECT_<ref>.json` | Raw output path |
@@ -394,7 +394,7 @@ mutations, sendEvent actions, scheduled actions, and ruleset durations.
 **How to run:**
 
 ```bash
-npx tsx scripts/order-event-inspect.ts <ORDER_REF> --profile SAGIRISH
+npx tsx scripts/order-event-inspect.ts <ORDER_REF> --profile YOUR_PROFILE
 npx tsx scripts/order-event-inspect.ts HD-001 --profile HMDEV --out /tmp/inspect.json
 ```
 
@@ -411,16 +411,16 @@ and entity ref.
 
 ```bash
 # Fetch specific events by ID
-npx tsx scripts/check-event-status.ts --event-id <uuid> --profile SAGIRISH
+npx tsx scripts/check-event-status.ts --event-id <uuid> --profile YOUR_PROFILE
 
 # List events by name
-npx tsx scripts/check-event-status.ts --event-name ConfirmValidation --profile SAGIRISH
+npx tsx scripts/check-event-status.ts --event-name ConfirmValidation --profile YOUR_PROFILE
 
 # List events by entity ref
-npx tsx scripts/check-event-status.ts --entity-ref HD-001 --profile SAGIRISH
+npx tsx scripts/check-event-status.ts --entity-ref HD-001 --profile YOUR_PROFILE
 
 # Combine filters
-npx tsx scripts/check-event-status.ts --event-name ConfirmValidation --entity-ref HD-001 --count 20 --profile SAGIRISH
+npx tsx scripts/check-event-status.ts --event-name ConfirmValidation --entity-ref HD-001 --count 20 --profile YOUR_PROFILE
 ```
 
 **Options:**

package/docs/RUNBOOK.md

@@ -92,8 +92,11 @@ Run tools in this order:
 7. `event.get` using ID returned by send
 8. `graphql.query` simple read
 9. `entity.get` — verify entity lookup works (e.g., look up a known order by ref)
-10. `workflow.transitions` (optional) — verify User Action API access for a known trigger
-11. `graphql.queryAll` — verify auto-pagination and run-level timeout
+10. `setting.get` with `name: "fc.mystique.manifest.%"` — verify settings read access and wildcard support
+11. `workflow.list` — verify REST workflow API access (list all workflows for a retailer)
+12. `workflow.get` with `entityType: "ORDER", entitySubtype: "HD"` — verify specific workflow fetch
+13. `workflow.transitions` (optional) — verify User Action API access for a known trigger
+14. `graphql.queryAll` — verify auto-pagination and run-level timeout
 12. `graphql.introspect` with `listMutations: true` — verify schema access
 13. `environment.discover` with `include: ["retailer", "locations"]` — verify environment snapshot
 14. `environment.validate` with `checks: ["auth", "retailer", "locations"]` — verify pre-flight checks