@fluentcommerce/fluent-mcp-extn 0.3.0 → 0.3.1

package/dist/settings-tools.js

@@ -424,12 +424,14 @@ export async function handleSettingGet(args, ctx) {
     // If outputFile is provided and exactly one setting matches, write to file
     if (parsed.outputFile && settings.length === 1) {
         const setting = settings[0];
-        const content = setting.lobValue ?? setting.value ?? "";
-        // Try to pretty-print JSON content
+        const raw = setting.lobValue ?? setting.value ?? "";
+        // lobValue may be a parsed object (valueType: JSON) or a string — normalize to string
+        const content = typeof raw === "string" ? raw : JSON.stringify(raw, null, 2);
+        // Try to pretty-print JSON content (if it's a JSON string, reformat)
         let fileContent = content;
         try {
-            const parsed = JSON.parse(content);
-            fileContent = JSON.stringify(parsed, null, 2);
+            const obj = JSON.parse(content);
+            fileContent = JSON.stringify(obj, null, 2);
         }
         catch {
             // Not JSON — write as-is
@@ -462,7 +464,9 @@ export async function handleSettingGet(args, ctx) {
         fs.mkdirSync(outputDir, { recursive: true });
         const savedFiles = [];
         for (const setting of settings) {
-            const content = setting.lobValue ?? setting.value ?? "";
+            const raw = setting.lobValue ?? setting.value ?? "";
+            // lobValue may be a parsed object (valueType: JSON) or a string — normalize to string
+            const content = typeof raw === "string" ? raw : JSON.stringify(raw, null, 2);
             let fileContent = content;
             try {
                 const p = JSON.parse(content);

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/TOOL_REFERENCE.md

@@ -1575,7 +1575,7 @@ Uses the GraphQL `settings(name:)` query. Returns metadata inline (name, context
 {
   "name": "fc.mystique.manifest.oms",
   "context": "ACCOUNT",
-  "outputFile": "./accounts/SAGIRISH/manifests/backups/fc.mystique.manifest.oms.json"
+  "outputFile": "./accounts/<PROFILE>/manifests/backups/fc.mystique.manifest.oms.json"
 }
 ```
 
@@ -1593,7 +1593,7 @@ Uses the GraphQL `settings(name:)` query. Returns metadata inline (name, context
 ```json
 {
   "name": "fc.mystique.manifest.%",
-  "outputFile": "./accounts/SAGIRISH/manifests/backups/"
+  "outputFile": "./accounts/<PROFILE>/manifests/backups/"
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluentcommerce/fluent-mcp-extn",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "MCP (Model Context Protocol) extension server for Fluent Commerce. Exposes event dispatch, transition actions, GraphQL execution, Prometheus metrics, batch ingestion, and webhook validation as MCP tools.",
   "type": "module",
   "main": "dist/index.js",