yaml-flow 7.1.0 → 8.0.0

package/examples/{example-board → board}/demo-server.js

@@ -7,12 +7,11 @@ import os from 'node:os';
 import net from 'node:net';
 import { spawnSync, spawn } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
-import { createRequire } from 'node:module';
 
 import {
   createMultiBoardServerRuntime,
   createSingleBoardServerRuntime,
-} from 'yaml-flow/server-runtime';
+} from 'yaml-flow/board-live-cards-server-runtime';
 
 import {
   createFsBoardPlatformAdapter,
@@ -23,23 +22,7 @@ import {
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-const _require = createRequire(import.meta.url);
-
-function resolveYamlFlowDir() {
-  try {
-    return path.dirname(_require.resolve('yaml-flow/package.json'));
-  } catch {
-    return null;
-  }
-}
-
-const _yamlFlowDir = resolveYamlFlowDir();
-
-// cliDir must point to the yaml-flow root so buildBoardCliInvocation finds
-// board-live-cards-cli.js for task-executor completion callbacks.
-// demo-src/example-board is 2 levels below the yaml-flow root.
-const YAML_FLOW_CLI_DIR = _yamlFlowDir || path.resolve(__dirname, '..', '..');
-const _pkgStepMachineCli = _yamlFlowDir ? path.join(_yamlFlowDir, 'step-machine-cli.js') : null;
+const cliArgs = process.argv.slice(2);
 
 function loadServerConfig() {
   const configPath = path.join(__dirname, 'demo-server-config.json');
@@ -77,7 +60,7 @@ function resolveKindRefFromConfig(configValue) {
 const serverConfig = loadServerConfig();
 const configuredCardsDir = resolveFromConfig(serverConfig.cardsDir);
 const configuredTaskExecutorPath = resolveFromConfig(serverConfig.taskExecutorPath || serverConfig.demoTaskExecutorPath);
-const configuredStepMachineCliPath = resolveFromConfig(serverConfig.stepMachineCliPath) || _pkgStepMachineCli;
+const configuredStepMachineCliPath = resolveFromConfig(serverConfig.stepMachineCliPath);
 const configuredChatHandlerPath = resolveFromConfig(serverConfig.chatHandlerPath);
 const configuredInferenceAdapterPath = resolveFromConfig(serverConfig.inferenceAdapterPath);
 const configuredGandalfCardsDir = resolveFromConfig(serverConfig.gandalfCardsDir);
@@ -97,7 +80,9 @@ if (!process.env.DEMO_INFERENCE_ADAPTER_PATH && configuredInferenceAdapterPath)
 }
 
 const PORT = Number(process.env.DEMO_SERVER_PORT || serverConfig.port || 7799);
-const RESET_ON_START = process.argv.includes('--reset');
+const cardsPatternArgIndex = cliArgs.indexOf('--cards-pattern');
+const cliCardsPattern = cardsPatternArgIndex !== -1 ? cliArgs[cardsPatternArgIndex + 1] : null;
+const selectedCardsPattern = (process.env.DEMO_CARDS_PATTERN || cliCardsPattern || '').trim() || null;
 
 const CORS_HEADERS = {
   'Access-Control-Allow-Origin': '*',
@@ -132,12 +117,23 @@ const defaultGandalfInferenceAdapterPath = process.env.DEMO_GANDALF_INFERENCE_AD
 // platform-free server runtime.
 // ---------------------------------------------------------------------------
 
-function createFsCardSource(cardsDir) {
+function wildcardToRegExp(pattern) {
+  const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+  return new RegExp(`^${escaped.replace(/\*/g, '.*').replace(/\?/g, '.')}$`);
+}
+
+function createFsCardSource(cardsDir, cardPattern = null) {
+  const cardRegex = cardPattern ? wildcardToRegExp(cardPattern) : null;
   return {
     listCards() {
       if (!fs.existsSync(cardsDir)) return [];
       return fs.readdirSync(cardsDir)
-        .filter(f => f.endsWith('.json'))
+        .filter(f => {
+          if (!f.endsWith('.json')) return false;
+          if (!cardRegex) return true;
+          const cardId = path.basename(f, '.json');
+          return cardRegex.test(cardId);
+        })
         .map(f => {
           try { return JSON.parse(fs.readFileSync(path.join(cardsDir, f), 'utf-8')); }
           catch { return null; }
@@ -275,7 +271,7 @@ function createNamedPipeNotificationTransport() {
 
 const serverMetaRef = process.env.DEMO_SERVER_META_STORE_REF || configuredServerMetaStoreRef || serializeRef({ kind: 'fs-path', value: setupDir });
 const serverMetaAdapter = createFsBoardPlatformAdapter(
-  parseRef(serverMetaRef), YAML_FLOW_CLI_DIR, { suppressSpawn: true },
+  parseRef(serverMetaRef), { suppressSpawn: true },
 );
 const serverMetaStore = createArtifactsStore(serverMetaAdapter.blobStorage('server-meta'));
 
@@ -304,7 +300,7 @@ function buildBoardContextConfig(label, boardDir, taskExecPath, chatHandlerPath,
 
   const notifyChannel = `yaml-flow-server-${label}-${boardId}-${process.pid}`;
   const baseRef = parseRef(serializeRef({ kind: 'fs-path', value: boardDir }));
-  const boardAdapter = createFsBoardPlatformAdapter(baseRef, YAML_FLOW_CLI_DIR, {
+  const boardAdapter = createFsBoardPlatformAdapter(baseRef, {
     notifyChannel,
   });
   // In the server context the drain loop is driven in-process; suppress the
@@ -312,7 +308,7 @@ function buildBoardContextConfig(label, boardDir, taskExecPath, chatHandlerPath,
   boardAdapter.requestProcessAccumulated = () => {};
   // Artifacts adapter rooted at runtimeCardsDir so chats/ and files/ are siblings of store/.
   const artifactsRef = parseRef(serializeRef({ kind: 'fs-path', value: runtimeCardsDir }));
-  const artifactsAdapter = createFsBoardPlatformAdapter(artifactsRef, YAML_FLOW_CLI_DIR, { suppressSpawn: true });
+  const artifactsAdapter = createFsBoardPlatformAdapter(artifactsRef, { suppressSpawn: true });
 
   const cardStoreRef = serializeRef({ kind: 'fs-path', value: runtimeCardStoreDir });
 
@@ -390,7 +386,7 @@ const runtime = createMultiBoardServerRuntime({
     const existing = singleBoardRuntime.cardStore.get({});
     const isEmpty = existing.status !== 'success' || !existing.data?.cards?.length;
     if (isEmpty) {
-      const cards = createFsCardSource(sourceCardsDir).listCards();
+      const cards = createFsCardSource(sourceCardsDir, selectedCardsPattern).listCards();
       if (cards.length) singleBoardRuntime.cardStore.set({ body: cards });
     }
     // Seed gandalf board if present
@@ -410,27 +406,6 @@ const runtime = createMultiBoardServerRuntime({
   },
 });
 
-// ---------------------------------------------------------------------------
-// Reset
-// ---------------------------------------------------------------------------
-
-function resetRuntime() {
-  if (fs.existsSync(setupDir)) {
-    fs.rmSync(setupDir, { recursive: true, force: true });
-    console.log(`[demo-server] reset: wiped ${setupDir}`);
-  }
-  const chatSessionsDir = serverConfig.chatSessionsDir
-    ? path.resolve(__dirname, serverConfig.chatSessionsDir)
-    : path.join(os.tmpdir(), 'demo-chat-handler-sessions');
-  if (fs.existsSync(chatSessionsDir)) {
-    fs.rmSync(chatSessionsDir, { recursive: true, force: true });
-    console.log(`[demo-server] reset: wiped ${chatSessionsDir}`);
-  }
-}
-
-if (RESET_ON_START) {
-  resetRuntime();
-}
 
 // ---------------------------------------------------------------------------
 // Demo-setup — host-level concern (not a runtime concern).

package/examples/{example-board → board}/demo-shell-with-server.html

@@ -4,7 +4,7 @@
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
   <title>Example Board Demo (Server Runtime)</title>
-  <link rel="icon" type="image/svg+xml" href="favicon.svg" />
+  <link rel="icon" type="image/svg+xml" href="../../browser/favicon.svg" />
   <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet" />
   <style>
     /* Scale down markdown headings inside cards to stay in proportion with card body text */
@@ -19,8 +19,8 @@
   <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/dompurify/dist/purify.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/leader-line/leader-line.min.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@7.1.0/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@7.1.0/browser/board-livecards-client.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.0.0/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.0.0/browser/board-livecards-client.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

package/examples/{example-board → board}/demo-task-executor.js

@@ -60,10 +60,9 @@ import path from 'node:path';
 import os from 'node:os';
 import { execFileSync } from 'node:child_process';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { parseRef, blobStorageForRef, reportComplete, reportFailed } from 'yaml-flow/storage-refs';
-import { loadStepFlow, createStepMachine, MemoryStore } from '../../dist/index.js';
-import { buildStepHandlersForFlow } from '../../dist/step-machine-public/index.js';
-import { invokeRefSync } from '../../dist/cli/node/execution-adapter.js';
+import { parseRef, blobStorageForRef, reportComplete, reportFailed } from 'yaml-flow/board-worker-adapter';
+import { loadStepFlow, createStepMachine, MemoryStore, buildStepHandlersForFlow } from 'yaml-flow/step-machine-public';
+import { invokeRefSync } from 'yaml-flow/board-live-cards-node';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const SOURCE_DEF_FLOWS_FILE = path.join(__dirname, 'source_def_flows.json');
@@ -212,7 +211,9 @@ function loadSourceDefFlowsConfig() {
   try {
     return readJson(SOURCE_DEF_FLOWS_FILE);
   } catch (err) {
-    fail(`Cannot read source flow registry at ${SOURCE_DEF_FLOWS_FILE}: ${String(err && err.message || err)}`);
+    fail(
+      `Cannot read source flow registry (${SOURCE_DEF_FLOWS_FILE}): ${String(err && err.message || err)}`,
+    );
   }
 }
 
@@ -356,6 +357,22 @@ async function executeStepMachineSourceFlow(context) {
   };
 }
 
+async function resolveAndExecuteSourceFlow(sourceDef, extra, refs = {}) {
+  const registry = loadSourceDefFlowsConfig();
+  const kind = resolveSourceKind(sourceDef, registry);
+  const flowResult = await executeStepMachineSourceFlow({
+    kind,
+    registry,
+    sourceDef,
+    extra,
+    inRef: refs.inRef,
+    outRef: refs.outRef,
+    errRef: refs.errRef,
+    mockDb: MOCK_DB,
+  });
+  return { kind, flowResult };
+}
+
 async function runSourceFetchSubcommand(argv) {
   const inIdx = argv.indexOf('--in-ref');
   const outIdx = argv.indexOf('--out-ref');
@@ -418,29 +435,15 @@ async function runSourceFetchSubcommand(argv) {
     failRef(`Cannot resolve source_def: ${String(err && err.message || err)}`, callback);
   }
 
-  const registry = loadSourceDefFlowsConfig();
   let kind;
-  try {
-    kind = resolveSourceKind(sourceDef, registry);
-  } catch (err) {
-    failRef(String(err && err.message || err), callback);
-  }
-
   let flowResult;
   try {
-    flowResult = await executeStepMachineSourceFlow({
-      kind,
-      registry,
-      sourceDef,
-      extra,
-      inRef,
-      outRef,
-      errRef,
-      mockDb: MOCK_DB,
-    });
+    const resolved = await resolveAndExecuteSourceFlow(sourceDef, extra, { inRef, outRef, errRef });
+    kind = resolved.kind;
+    flowResult = resolved.flowResult;
   } catch (err) {
     const detail = (err && (err.stderr || err.stdout)) ? `\n${err.stderr || err.stdout}`.trimEnd() : '';
-    failRef(`${kind} invocation failed: ${String(err && err.message || err)}${detail}`, callback);
+    failRef(`source invocation failed: ${String(err && err.message || err)}${detail}`, callback);
   }
 
   if (!flowResult?.wroteOutputDirectly) {
@@ -462,6 +465,46 @@ async function runSourceFetchSubcommand(argv) {
 
 }
 
+async function probeSourcePreflightSubcommand(argv) {
+  const extraIdx = argv.indexOf('--extra');
+  const extraB64 = extraIdx !== -1 ? argv[extraIdx + 1] : undefined;
+
+  let extra = {};
+  if (extraB64) {
+    try { extra = JSON.parse(Buffer.from(extraB64, 'base64').toString('utf-8')); }
+    catch { /* ignore malformed extra */ }
+  }
+
+  const startedAt = Date.now();
+  try {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    const raw = Buffer.concat(chunks).toString('utf-8').trim();
+    if (!raw) {
+      console.log(JSON.stringify({ ok: false, reachable: false, latencyMs: Date.now() - startedAt, error: 'Missing probe input JSON on stdin' }));
+      process.exit(0);
+    }
+
+    let sourceDef;
+    try {
+      sourceDef = JSON.parse(raw);
+    } catch (err) {
+      console.log(JSON.stringify({ ok: false, reachable: false, latencyMs: Date.now() - startedAt, error: `Invalid probe JSON: ${String(err && err.message || err)}` }));
+      process.exit(0);
+    }
+
+    await resolveAndExecuteSourceFlow(sourceDef, extra);
+    console.log(JSON.stringify({ ok: true, reachable: true, latencyMs: Date.now() - startedAt }));
+    process.exit(0);
+  } catch (err) {
+    const detail = (err && (err.stderr || err.stdout)) ? `\n${err.stderr || err.stdout}`.trimEnd() : '';
+    console.log(JSON.stringify({ ok: false, reachable: false, latencyMs: Date.now() - startedAt, error: `source invocation failed: ${String(err && err.message || err)}${detail}` }));
+    process.exit(0);
+  }
+}
+
 // ---------------------------------------------------------------------------
 // validate-source-def — structural validation of a source definition
 // ---------------------------------------------------------------------------
@@ -547,7 +590,7 @@ function validateSourceDefSubcommand(argv) {
 const CAPABILITIES = {
   version: '1.0',
   executor: 'demo-task-executor',
-  subcommands: ['run-source-fetch', 'describe-capabilities', 'validate-source-def'],
+  subcommands: ['run-source-fetch', 'probe-source-preflight', 'describe-capabilities', 'validate-source-def'],
   sourceKinds: {
     mock: {
       description: 'Look up a key in a hardcoded MOCK_DB dictionary.',
@@ -658,6 +701,10 @@ async function main() {
     await runSourceFetchSubcommand(process.argv.slice(3));
     return;
   }
+  if (sub === 'probe-source-preflight') {
+    await probeSourcePreflightSubcommand(process.argv.slice(3));
+    return;
+  }
   if (sub === 'describe' || sub === 'describe-capabilities') {
     describeCapabilities();
     return;

package/examples/board/gandalf-cards/card-source-kinds.json

@@ -0,0 +1,36 @@
+{
+  "id": "card-source-kinds",
+  "meta": {
+    "title": "Source Connection Types",
+    "tags": ["admin"],
+    "desc": "Reference card listing the source def kinds supported by the demo task executor.",
+    "_gandalfCard": true
+  },
+  "provides": [],
+  "compute": [],
+  "view": {
+    "elements": [
+      {
+        "kind": "table",
+        "label": "Supported connection types",
+        "data": {
+          "bind": "card_data.kinds",
+          "columns": ["kind", "description"]
+        }
+      }
+    ],
+    "layout": {
+      "board": { "col": 4, "order": 99 },
+      "canvas": { "x": 900, "y": 50, "w": 480, "h": 240 }
+    }
+  },
+  "card_data": {
+    "kinds": [
+      { "kind": "mock", "description": "Look up a key in the built-in MOCK_DB dictionary and return static JSON." },
+      { "kind": "copilot", "description": "Invoke GitHub Copilot CLI using copilot.prompt_template (or top-level prompt_template shorthand) with {{key}} interpolation from _projections and args." },
+      { "kind": "workiq", "description": "Invoke WorkIQ (Microsoft 365 Copilot) using workiq.query_template with {{key}} interpolation. Requires workiq CLI + az login." },
+      { "kind": "url", "description": "Single URL fetch via curl with {{key}} interpolation from _projections. Supports method, headers, args, tickersFrom, and cacheTimeout (seconds)." },
+      { "kind": "url-list", "description": "Fan-out fetch over _projections.url_list (string[]), returning an array of raw JSON responses. Supports method, headers, and cacheTimeout." }
+    ]
+  }
+}

package/examples/board/gandalf-cards/cards/_index.json

@@ -0,0 +1,7 @@
+{
+  "card-source-kinds": {
+    "key": "card-source-kinds",
+    "checksum": "",
+    "updatedAt": "2026-05-07T19:32:58.245Z"
+  }
+}

package/examples/board/gandalf-cards/cards/card-source-kinds.json

@@ -0,0 +1,64 @@
+{
+  "id": "card-source-kinds",
+  "meta": {
+    "title": "Source Connection Types",
+    "tags": [
+      "admin"
+    ],
+    "desc": "Reference card listing the source def kinds supported by the demo task executor.",
+    "_gandalfCard": true
+  },
+  "provides": [],
+  "compute": [],
+  "view": {
+    "elements": [
+      {
+        "kind": "table",
+        "label": "Supported connection types",
+        "data": {
+          "bind": "card_data.kinds",
+          "columns": [
+            "kind",
+            "description"
+          ]
+        }
+      }
+    ],
+    "layout": {
+      "board": {
+        "col": 4,
+        "order": 99
+      },
+      "canvas": {
+        "x": 900,
+        "y": 50,
+        "w": 480,
+        "h": 240
+      }
+    }
+  },
+  "card_data": {
+    "kinds": [
+      {
+        "kind": "mock",
+        "description": "Look up a key in the built-in MOCK_DB dictionary and return static JSON."
+      },
+      {
+        "kind": "copilot",
+        "description": "Invoke GitHub Copilot CLI using copilot.prompt_template (or top-level prompt_template shorthand) with {{key}} interpolation from _projections and args."
+      },
+      {
+        "kind": "workiq",
+        "description": "Invoke WorkIQ (Microsoft 365 Copilot) using workiq.query_template with {{key}} interpolation. Requires workiq CLI + az login."
+      },
+      {
+        "kind": "url",
+        "description": "Single URL fetch via curl with {{key}} interpolation from _projections. Supports method, headers, args, tickersFrom, and cacheTimeout (seconds)."
+      },
+      {
+        "kind": "url-list",
+        "description": "Fan-out fetch over _projections.url_list (string[]), returning an array of raw JSON responses. Supports method, headers, and cacheTimeout."
+      }
+    ]
+  }
+}

package/examples/board/source-def-flows/copilot.flow.json

@@ -0,0 +1,33 @@
+{
+  "id": "demo-source-copilot",
+  "settings": {
+    "start_step": "execute",
+    "max_total_steps": 8,
+    "timeout_ms": 180000
+  },
+  "steps": {
+    "execute": {
+      "description": "Execute copilot source def",
+      "handler": {
+        "type": "ref",
+        "howToRun": "demo-local-module",
+        "whatToRun": { "kind": "fs-path", "value": "./source-def-handlers/copilot-source-handler.js" }
+      },
+      "transitions": {
+        "success": "completed",
+        "failure": "failed"
+      }
+    }
+  },
+  "terminal_states": {
+    "completed": {
+      "description": "Copilot source succeeded",
+      "return_intent": "success",
+      "return_artifacts": ["resultValue", "wroteOutputDirectly"]
+    },
+    "failed": {
+      "description": "Copilot source failed",
+      "return_intent": "failure"
+    }
+  }
+}

package/examples/board/source-def-flows/mock.flow.json

@@ -0,0 +1,35 @@
+{
+  "id": "demo-source-mock",
+  "settings": {
+    "start_step": "execute",
+    "max_total_steps": 5,
+    "timeout_ms": 30000
+  },
+  "steps": {
+    "execute": {
+      "description": "Execute mock source def",
+      "handler": {
+        "type": "compute-jsonata",
+        "expr": [
+          "data.resultValue = $lookup(expects_data.mockDb, expects_data.sourceDef.mock)",
+          "result = $exists(data.resultValue) ? \"success\" : \"failure\""
+        ]
+      },
+      "transitions": {
+        "success": "completed",
+        "failure": "failed"
+      }
+    }
+  },
+  "terminal_states": {
+    "completed": {
+      "description": "Mock lookup succeeded",
+      "return_intent": "success",
+      "return_artifacts": ["resultValue", "wroteOutputDirectly"]
+    },
+    "failed": {
+      "description": "Mock lookup failed",
+      "return_intent": "failure"
+    }
+  }
+}

package/examples/board/source-def-flows/url-list.flow.json

@@ -0,0 +1,33 @@
+{
+  "id": "demo-source-url-list",
+  "settings": {
+    "start_step": "execute",
+    "max_total_steps": 10,
+    "timeout_ms": 60000
+  },
+  "steps": {
+    "execute": {
+      "description": "Execute URL list source def",
+      "handler": {
+        "type": "ref",
+        "howToRun": "demo-local-module",
+        "whatToRun": { "kind": "fs-path", "value": "./source-def-handlers/http-source-handler.js" }
+      },
+      "transitions": {
+        "success": "completed",
+        "failure": "failed"
+      }
+    }
+  },
+  "terminal_states": {
+    "completed": {
+      "description": "URL list fetch succeeded",
+      "return_intent": "success",
+      "return_artifacts": ["resultValue", "wroteOutputDirectly"]
+    },
+    "failed": {
+      "description": "URL list fetch failed",
+      "return_intent": "failure"
+    }
+  }
+}

package/examples/board/source-def-flows/url.flow.json

@@ -0,0 +1,33 @@
+{
+  "id": "demo-source-url",
+  "settings": {
+    "start_step": "execute",
+    "max_total_steps": 10,
+    "timeout_ms": 60000
+  },
+  "steps": {
+    "execute": {
+      "description": "Execute single URL source def",
+      "handler": {
+        "type": "ref",
+        "howToRun": "demo-local-module",
+        "whatToRun": { "kind": "fs-path", "value": "./source-def-handlers/http-source-handler.js" }
+      },
+      "transitions": {
+        "success": "completed",
+        "failure": "failed"
+      }
+    }
+  },
+  "terminal_states": {
+    "completed": {
+      "description": "URL fetch succeeded",
+      "return_intent": "success",
+      "return_artifacts": ["resultValue", "wroteOutputDirectly"]
+    },
+    "failed": {
+      "description": "URL fetch failed",
+      "return_intent": "failure"
+    }
+  }
+}

package/examples/board/source-def-flows/workiq.flow.json

@@ -0,0 +1,34 @@
+{
+  "id": "demo-source-workiq",
+  "settings": {
+    "start_step": "execute",
+    "max_total_steps": 8,
+    "timeout_ms": 120000
+  },
+  "steps": {
+    "execute": {
+      "description": "Execute workiq source def via demo-server HTTP proxy",
+      "handler": {
+        "type": "ref",
+        "howToRun": "http:post",
+        "whatToRun": { "kind": "http-url", "value": "/api/workiq/ask" }
+      },
+      "transitions": {
+        "success": "completed",
+        "failure": "failed"
+      }
+    }
+  },
+  "terminal_states": {
+    "completed": {
+      "description": "WorkIQ source succeeded",
+      "return_intent": "success",
+      "return_artifacts": ["resultValue", "wroteOutputDirectly"]
+    },
+    "failed": {
+      "description": "WorkIQ source failed",
+      "return_intent": "failure",
+      "return_artifacts": ["error"]
+    }
+  }
+}