@red-hat-developer-hub/backstage-plugin-augment-common 0.2.0

package/dist/index.esm.js

@@ -0,0 +1,7 @@
+export { augmentAccessPermission, augmentAdminPermission, augmentPermissions } from './permissions.esm.js';
+export { FileFormat, LEGACY_STAGE_MAP, LIFECYCLE_STAGE_ORDER, LIFECYCLE_TRANSITIONS, deriveRoleFromTopology, getAvailableTransitions, isValidTransition, normalizeLifecycleStage } from './types/shared.esm.js';
+export { DEFAULT_BRANDING } from './types/branding.esm.js';
+export { createDefaultWorkflow, isAgentNodeData, isGuardrailNodeData, isLogicNodeData, isToolNodeData, isUserInteractionNodeData } from './types/workflowBuilder.esm.js';
+export { WORKFLOW_TEMPLATES } from './templates/workflowTemplates.esm.js';
+export { GLOBAL_CONFIG_KEYS, PROVIDER_SCOPED_KEYS, isGlobalConfigKey, isProviderScopedKey, scopedConfigKey } from './types/provider.esm.js';
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/dist/permissions.cjs.js

@@ -0,0 +1,25 @@
+'use strict';
+
+var pluginPermissionCommon = require('@backstage/plugin-permission-common');
+
+const augmentAccessPermission = pluginPermissionCommon.createPermission({
+  name: "augment.access",
+  attributes: {
+    action: "read"
+  }
+});
+const augmentAdminPermission = pluginPermissionCommon.createPermission({
+  name: "augment.admin",
+  attributes: {
+    action: "update"
+  }
+});
+const augmentPermissions = [
+  augmentAccessPermission,
+  augmentAdminPermission
+];
+
+exports.augmentAccessPermission = augmentAccessPermission;
+exports.augmentAdminPermission = augmentAdminPermission;
+exports.augmentPermissions = augmentPermissions;
+//# sourceMappingURL=permissions.cjs.js.map

package/dist/permissions.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.cjs.js","sources":["../src/permissions.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { createPermission } from '@backstage/plugin-permission-common';\n\n/**\n * Permission to access the Augment plugin.\n *\n * Controls access to ALL Augment features. If a user has this\n * permission, they get full access. If not, they are blocked entirely.\n *\n * @public\n */\nexport const augmentAccessPermission = createPermission({\n  name: 'augment.access',\n  attributes: {\n    action: 'read',\n  },\n});\n\n/**\n * Permission to access admin features of the Augment plugin.\n *\n * Controls access to admin-only features such as document management,\n * swim lane/prompt editing, system prompt configuration, and branding.\n * Users with this permission see additional admin tabs in the UI.\n *\n * @public\n */\nexport const augmentAdminPermission = createPermission({\n  name: 'augment.admin',\n  attributes: {\n    action: 'update',\n  },\n});\n\n/**\n * List of all Augment permissions.\n *\n * To restrict access to a Keycloak group, configure RBAC policies in app-config.yaml:\n *\n * @example\n * ```yaml\n * permission:\n *   enabled: true\n *   rbac:\n *     policies:\n *       - g, group:default/augment-users, role:default/augment-user\n *       - p, role:default/augment-user, augment.access, read, allow\n *       - g, group:default/augment-admins, role:default/augment-admin\n *       - p, role:default/augment-admin, augment.access, read, allow\n *       - p, role:default/augment-admin, augment.admin, update, allow\n * ```\n *\n * @public\n */\nexport const augmentPermissions = [\n  augmentAccessPermission,\n  augmentAdminPermission,\n];\n"],"names":["createPermission"],"mappings":";;;;AAyBO,MAAM,0BAA0BA,uCAAA,CAAiB;AAAA,EACtD,IAAA,EAAM,gBAAA;AAAA,EACN,UAAA,EAAY;AAAA,IACV,MAAA,EAAQ;AAAA;AAEZ,CAAC;AAWM,MAAM,yBAAyBA,uCAAA,CAAiB;AAAA,EACrD,IAAA,EAAM,eAAA;AAAA,EACN,UAAA,EAAY;AAAA,IACV,MAAA,EAAQ;AAAA;AAEZ,CAAC;AAsBM,MAAM,kBAAA,GAAqB;AAAA,EAChC,uBAAA;AAAA,EACA;AACF;;;;;;"}

package/dist/permissions.esm.js

@@ -0,0 +1,21 @@
+import { createPermission } from '@backstage/plugin-permission-common';
+
+const augmentAccessPermission = createPermission({
+  name: "augment.access",
+  attributes: {
+    action: "read"
+  }
+});
+const augmentAdminPermission = createPermission({
+  name: "augment.admin",
+  attributes: {
+    action: "update"
+  }
+});
+const augmentPermissions = [
+  augmentAccessPermission,
+  augmentAdminPermission
+];
+
+export { augmentAccessPermission, augmentAdminPermission, augmentPermissions };
+//# sourceMappingURL=permissions.esm.js.map

package/dist/permissions.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.esm.js","sources":["../src/permissions.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { createPermission } from '@backstage/plugin-permission-common';\n\n/**\n * Permission to access the Augment plugin.\n *\n * Controls access to ALL Augment features. If a user has this\n * permission, they get full access. If not, they are blocked entirely.\n *\n * @public\n */\nexport const augmentAccessPermission = createPermission({\n  name: 'augment.access',\n  attributes: {\n    action: 'read',\n  },\n});\n\n/**\n * Permission to access admin features of the Augment plugin.\n *\n * Controls access to admin-only features such as document management,\n * swim lane/prompt editing, system prompt configuration, and branding.\n * Users with this permission see additional admin tabs in the UI.\n *\n * @public\n */\nexport const augmentAdminPermission = createPermission({\n  name: 'augment.admin',\n  attributes: {\n    action: 'update',\n  },\n});\n\n/**\n * List of all Augment permissions.\n *\n * To restrict access to a Keycloak group, configure RBAC policies in app-config.yaml:\n *\n * @example\n * ```yaml\n * permission:\n *   enabled: true\n *   rbac:\n *     policies:\n *       - g, group:default/augment-users, role:default/augment-user\n *       - p, role:default/augment-user, augment.access, read, allow\n *       - g, group:default/augment-admins, role:default/augment-admin\n *       - p, role:default/augment-admin, augment.access, read, allow\n *       - p, role:default/augment-admin, augment.admin, update, allow\n * ```\n *\n * @public\n */\nexport const augmentPermissions = [\n  augmentAccessPermission,\n  augmentAdminPermission,\n];\n"],"names":[],"mappings":";;AAyBO,MAAM,0BAA0B,gBAAA,CAAiB;AAAA,EACtD,IAAA,EAAM,gBAAA;AAAA,EACN,UAAA,EAAY;AAAA,IACV,MAAA,EAAQ;AAAA;AAEZ,CAAC;AAWM,MAAM,yBAAyB,gBAAA,CAAiB;AAAA,EACrD,IAAA,EAAM,eAAA;AAAA,EACN,UAAA,EAAY;AAAA,IACV,MAAA,EAAQ;AAAA;AAEZ,CAAC;AAsBM,MAAM,kBAAA,GAAqB;AAAA,EAChC,uBAAA;AAAA,EACA;AACF;;;;"}

package/dist/templates/workflowTemplates.cjs.js

@@ -0,0 +1,333 @@
+'use strict';
+
+function template(id, name, description, nodes, edges) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    id,
+    name,
+    description,
+    version: 0,
+    createdAt: now,
+    updatedAt: now,
+    status: "draft",
+    nodes,
+    edges,
+    settings: {
+      maxTurns: 10,
+      conversationPersistence: true,
+      tracingEnabled: true
+    }
+  };
+}
+const WORKFLOW_TEMPLATES = [
+  // 1. Simple Q&A Agent — the simplest working workflow
+  template(
+    "tpl-simple-qa",
+    "Simple Q&A Agent",
+    "A basic single-agent workflow that answers questions. The simplest starting point for any new agent.",
+    [
+      {
+        id: "start_1",
+        type: "start",
+        position: { x: 50, y: 200 },
+        data: { inputDescription: "User question" },
+        label: "Start"
+      },
+      {
+        id: "agent_1",
+        type: "agent",
+        position: { x: 300, y: 200 },
+        data: {
+          name: "Assistant",
+          instructions: "You are a helpful, knowledgeable assistant. Answer the user's question clearly and concisely. Use markdown formatting when it helps readability (bullet points, bold, code blocks)."
+        },
+        label: "Assistant"
+      },
+      {
+        id: "end_1",
+        type: "end",
+        position: { x: 560, y: 200 },
+        data: {},
+        label: "End"
+      }
+    ],
+    [
+      { id: "e1", source: "start_1", target: "agent_1", type: "sequence" },
+      { id: "e2", source: "agent_1", target: "end_1", type: "sequence" }
+    ]
+  ),
+  // 2. Smart Router — classification + if/else branching
+  template(
+    "tpl-smart-router",
+    "Smart Router",
+    "Classifies user input as technical or general, then routes to the appropriate specialist agent using if/else logic.",
+    [
+      {
+        id: "start_1",
+        type: "start",
+        position: { x: 50, y: 250 },
+        data: { inputDescription: "User message" },
+        label: "Start"
+      },
+      {
+        id: "classify_1",
+        type: "classify",
+        position: { x: 270, y: 250 },
+        data: {
+          classifications: [
+            {
+              label: "technical",
+              description: "Programming, code, APIs, servers, debugging, or technology questions"
+            },
+            {
+              label: "general",
+              description: "General conversation, greetings, or non-technical questions"
+            }
+          ],
+          instructions: 'Classify the user input. Choose "technical" if it asks about programming, code, APIs, servers, debugging, or technology. Choose "general" for everything else.'
+        },
+        label: "Topic Classifier"
+      },
+      {
+        id: "logic_1",
+        type: "logic",
+        position: { x: 520, y: 250 },
+        data: {
+          kind: "if_else",
+          condition: "classify_1_output && classify_1_output.classification === 'technical'"
+        },
+        label: "Is Technical?"
+      },
+      {
+        id: "agent_tech",
+        type: "agent",
+        position: { x: 780, y: 130 },
+        data: {
+          name: "Tech Expert",
+          instructions: "You are a senior software engineer. Give concise, technically accurate answers about programming, APIs, DevOps, and technology. Use code examples when helpful. Keep responses brief but precise."
+        },
+        label: "Tech Expert"
+      },
+      {
+        id: "agent_general",
+        type: "agent",
+        position: { x: 780, y: 370 },
+        data: {
+          name: "Friendly Assistant",
+          instructions: "You are a warm, friendly assistant. Answer general questions in a conversational, approachable tone. Be helpful and brief."
+        },
+        label: "Friendly Assistant"
+      },
+      {
+        id: "end_1",
+        type: "end",
+        position: { x: 1040, y: 250 },
+        data: {},
+        label: "End"
+      }
+    ],
+    [
+      { id: "e1", source: "start_1", target: "classify_1", type: "sequence" },
+      { id: "e2", source: "classify_1", target: "logic_1", type: "sequence" },
+      {
+        id: "e3",
+        source: "logic_1",
+        target: "agent_tech",
+        type: "sequence",
+        label: "true"
+      },
+      {
+        id: "e4",
+        source: "logic_1",
+        target: "agent_general",
+        type: "sequence",
+        label: "false"
+      },
+      { id: "e5", source: "agent_tech", target: "end_1", type: "sequence" },
+      { id: "e6", source: "agent_general", target: "end_1", type: "sequence" }
+    ]
+  ),
+  // 3. Research & Summarize — multi-agent chaining
+  template(
+    "tpl-research-summarize",
+    "Research & Summarize",
+    "A two-agent pipeline: the first agent researches a topic in depth, then a second agent distills the findings into a concise summary.",
+    [
+      {
+        id: "start_1",
+        type: "start",
+        position: { x: 50, y: 200 },
+        data: {
+          inputDescription: "Research topic or question"
+        },
+        label: "Start"
+      },
+      {
+        id: "agent_research",
+        type: "agent",
+        position: { x: 300, y: 200 },
+        data: {
+          name: "Researcher",
+          instructions: "You are a thorough research analyst. Given a topic, provide a comprehensive analysis covering key facts, different perspectives, recent developments, and supporting details. Be detailed and well-organized. Use headers and bullet points."
+        },
+        label: "Researcher"
+      },
+      {
+        id: "agent_summarize",
+        type: "agent",
+        position: { x: 580, y: 200 },
+        data: {
+          name: "Summarizer",
+          instructions: "You are an expert editor and summarizer. Take the detailed research provided and distill it into a clear, concise executive summary (3-5 key bullet points). Highlight only the most important takeaways. End with a one-sentence conclusion."
+        },
+        label: "Summarizer"
+      },
+      {
+        id: "end_1",
+        type: "end",
+        position: { x: 840, y: 200 },
+        data: {},
+        label: "End"
+      }
+    ],
+    [
+      {
+        id: "e1",
+        source: "start_1",
+        target: "agent_research",
+        type: "sequence"
+      },
+      {
+        id: "e2",
+        source: "agent_research",
+        target: "agent_summarize",
+        type: "sequence"
+      },
+      {
+        id: "e3",
+        source: "agent_summarize",
+        target: "end_1",
+        type: "sequence"
+      }
+    ]
+  ),
+  // 4. Kubernetes Assistant — MCP tool integration
+  template(
+    "tpl-k8s-assistant",
+    "Kubernetes Assistant",
+    "Connects to a Kubernetes MCP server for live cluster operations \u2014 list pods, namespaces, deployments, and more.",
+    [
+      {
+        id: "start_1",
+        type: "start",
+        position: { x: 50, y: 200 },
+        data: {
+          inputDescription: "Kubernetes question or command"
+        },
+        label: "Start"
+      },
+      {
+        id: "mcp_1",
+        type: "mcp",
+        position: { x: 300, y: 200 },
+        data: {
+          serverUrl: "https://kubernetes-mcp-server-ocp-mcp-server.apps.ocp.v7hjl.sandbox2288.opentlc.com",
+          serverLabel: "k8s",
+          requireApproval: "never"
+        },
+        label: "K8s MCP Server"
+      },
+      {
+        id: "agent_1",
+        type: "agent",
+        position: { x: 580, y: 200 },
+        data: {
+          name: "K8s Assistant",
+          instructions: "You are a Kubernetes expert assistant with access to a live cluster. Use the available MCP tools to query the cluster and answer the user's question. Format output clearly using markdown tables or lists. Always show the namespace and resource name."
+        },
+        label: "K8s Assistant"
+      },
+      {
+        id: "end_1",
+        type: "end",
+        position: { x: 840, y: 200 },
+        data: {},
+        label: "End"
+      }
+    ],
+    [
+      { id: "e1", source: "start_1", target: "mcp_1", type: "sequence" },
+      { id: "e2", source: "mcp_1", target: "agent_1", type: "sequence" },
+      { id: "e3", source: "agent_1", target: "end_1", type: "sequence" }
+    ]
+  ),
+  // 5. Content Moderator — set_state + transform + agent pipeline
+  template(
+    "tpl-content-moderator",
+    "Content Moderator",
+    "Demonstrates data flow: sets metadata via state, transforms it into context, then an agent uses that context to moderate content.",
+    [
+      {
+        id: "start_1",
+        type: "start",
+        position: { x: 50, y: 200 },
+        data: { inputDescription: "Content to moderate" },
+        label: "Start"
+      },
+      {
+        id: "set_state_1",
+        type: "set_state",
+        position: { x: 280, y: 200 },
+        data: {
+          assignments: {
+            content_type: "'user_generated'",
+            platform: "'public_forum'",
+            policy_version: "'v2.1'"
+          }
+        },
+        label: "Set Metadata"
+      },
+      {
+        id: "transform_1",
+        type: "transform",
+        position: { x: 520, y: 200 },
+        data: {
+          expression: "`Content type: ${content_type}, Platform: ${platform}, Policy: ${policy_version}`",
+          outputVariable: "moderation_context"
+        },
+        label: "Build Context"
+      },
+      {
+        id: "agent_1",
+        type: "agent",
+        position: { x: 780, y: 200 },
+        data: {
+          name: "Moderator",
+          instructions: "You are a content moderation specialist. Review the user-submitted content for policy violations. Consider the moderation context (content type, platform, policy version). Respond with:\n1. **Verdict**: APPROVE or FLAG\n2. **Reason**: Brief explanation\n3. **Category**: If flagged, specify (spam, hate speech, harassment, misinformation, other)\n4. **Confidence**: High / Medium / Low"
+        },
+        label: "Moderator"
+      },
+      {
+        id: "end_1",
+        type: "end",
+        position: { x: 1040, y: 200 },
+        data: {},
+        label: "End"
+      }
+    ],
+    [
+      { id: "e1", source: "start_1", target: "set_state_1", type: "sequence" },
+      {
+        id: "e2",
+        source: "set_state_1",
+        target: "transform_1",
+        type: "sequence"
+      },
+      { id: "e3", source: "transform_1", target: "agent_1", type: "sequence" },
+      { id: "e4", source: "agent_1", target: "end_1", type: "sequence" }
+    ]
+  )
+];
+
+exports.WORKFLOW_TEMPLATES = WORKFLOW_TEMPLATES;
+//# sourceMappingURL=workflowTemplates.cjs.js.map

package/dist/templates/workflowTemplates.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowTemplates.cjs.js","sources":["../../src/templates/workflowTemplates.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  WorkflowDefinition,\n  AgentNodeData,\n  StartNodeData,\n  ClassifyNodeData,\n  LogicNodeData,\n  McpNodeData,\n  TransformNodeData,\n  SetStateNodeData,\n  EndNodeData,\n} from '../types/workflowBuilder';\n\nfunction template(\n  id: string,\n  name: string,\n  description: string,\n  nodes: WorkflowDefinition['nodes'],\n  edges: WorkflowDefinition['edges'],\n): WorkflowDefinition {\n  const now = new Date().toISOString();\n  return {\n    id,\n    name,\n    description,\n    version: 0,\n    createdAt: now,\n    updatedAt: now,\n    status: 'draft',\n    nodes,\n    edges,\n    settings: {\n      maxTurns: 10,\n      conversationPersistence: true,\n      tracingEnabled: true,\n    },\n  };\n}\n\nexport const WORKFLOW_TEMPLATES: WorkflowDefinition[] = [\n  // 1. Simple Q&A Agent — the simplest working workflow\n  template(\n    'tpl-simple-qa',\n    'Simple Q&A Agent',\n    'A basic single-agent workflow that answers questions. The simplest starting point for any new agent.',\n    [\n      {\n        id: 'start_1',\n        type: 'start',\n        position: { x: 50, y: 200 },\n        data: { inputDescription: 'User question' } as StartNodeData,\n        label: 'Start',\n      },\n      {\n        id: 'agent_1',\n        type: 'agent',\n        position: { x: 300, y: 200 },\n        data: {\n          name: 'Assistant',\n          instructions:\n            \"You are a helpful, knowledgeable assistant. Answer the user's question clearly and concisely. Use markdown formatting when it helps readability (bullet points, bold, code blocks).\",\n        } as AgentNodeData,\n        label: 'Assistant',\n      },\n      {\n        id: 'end_1',\n        type: 'end',\n        position: { x: 560, y: 200 },\n        data: {} as EndNodeData,\n        label: 'End',\n      },\n    ],\n    [\n      { id: 'e1', source: 'start_1', target: 'agent_1', type: 'sequence' },\n      { id: 'e2', source: 'agent_1', target: 'end_1', type: 'sequence' },\n    ],\n  ),\n\n  // 2. Smart Router — classification + if/else branching\n  template(\n    'tpl-smart-router',\n    'Smart Router',\n    'Classifies user input as technical or general, then routes to the appropriate specialist agent using if/else logic.',\n    [\n      {\n        id: 'start_1',\n        type: 'start',\n        position: { x: 50, y: 250 },\n        data: { inputDescription: 'User message' } as StartNodeData,\n        label: 'Start',\n      },\n      {\n        id: 'classify_1',\n        type: 'classify',\n        position: { x: 270, y: 250 },\n        data: {\n          classifications: [\n            {\n              label: 'technical',\n              description:\n                'Programming, code, APIs, servers, debugging, or technology questions',\n            },\n            {\n              label: 'general',\n              description:\n                'General conversation, greetings, or non-technical questions',\n            },\n          ],\n          instructions:\n            'Classify the user input. Choose \"technical\" if it asks about programming, code, APIs, servers, debugging, or technology. Choose \"general\" for everything else.',\n        } as ClassifyNodeData,\n        label: 'Topic Classifier',\n      },\n      {\n        id: 'logic_1',\n        type: 'logic',\n        position: { x: 520, y: 250 },\n        data: {\n          kind: 'if_else',\n          condition:\n            \"classify_1_output && classify_1_output.classification === 'technical'\",\n        } as LogicNodeData,\n        label: 'Is Technical?',\n      },\n      {\n        id: 'agent_tech',\n        type: 'agent',\n        position: { x: 780, y: 130 },\n        data: {\n          name: 'Tech Expert',\n          instructions:\n            'You are a senior software engineer. Give concise, technically accurate answers about programming, APIs, DevOps, and technology. Use code examples when helpful. Keep responses brief but precise.',\n        } as AgentNodeData,\n        label: 'Tech Expert',\n      },\n      {\n        id: 'agent_general',\n        type: 'agent',\n        position: { x: 780, y: 370 },\n        data: {\n          name: 'Friendly Assistant',\n          instructions:\n            'You are a warm, friendly assistant. Answer general questions in a conversational, approachable tone. Be helpful and brief.',\n        } as AgentNodeData,\n        label: 'Friendly Assistant',\n      },\n      {\n        id: 'end_1',\n        type: 'end',\n        position: { x: 1040, y: 250 },\n        data: {} as EndNodeData,\n        label: 'End',\n      },\n    ],\n    [\n      { id: 'e1', source: 'start_1', target: 'classify_1', type: 'sequence' },\n      { id: 'e2', source: 'classify_1', target: 'logic_1', type: 'sequence' },\n      {\n        id: 'e3',\n        source: 'logic_1',\n        target: 'agent_tech',\n        type: 'sequence',\n        label: 'true',\n      },\n      {\n        id: 'e4',\n        source: 'logic_1',\n        target: 'agent_general',\n        type: 'sequence',\n        label: 'false',\n      },\n      { id: 'e5', source: 'agent_tech', target: 'end_1', type: 'sequence' },\n      { id: 'e6', source: 'agent_general', target: 'end_1', type: 'sequence' },\n    ],\n  ),\n\n  // 3. Research & Summarize — multi-agent chaining\n  template(\n    'tpl-research-summarize',\n    'Research & Summarize',\n    'A two-agent pipeline: the first agent researches a topic in depth, then a second agent distills the findings into a concise summary.',\n    [\n      {\n        id: 'start_1',\n        type: 'start',\n        position: { x: 50, y: 200 },\n        data: {\n          inputDescription: 'Research topic or question',\n        } as StartNodeData,\n        label: 'Start',\n      },\n      {\n        id: 'agent_research',\n        type: 'agent',\n        position: { x: 300, y: 200 },\n        data: {\n          name: 'Researcher',\n          instructions:\n            'You are a thorough research analyst. Given a topic, provide a comprehensive analysis covering key facts, different perspectives, recent developments, and supporting details. Be detailed and well-organized. Use headers and bullet points.',\n        } as AgentNodeData,\n        label: 'Researcher',\n      },\n      {\n        id: 'agent_summarize',\n        type: 'agent',\n        position: { x: 580, y: 200 },\n        data: {\n          name: 'Summarizer',\n          instructions:\n            'You are an expert editor and summarizer. Take the detailed research provided and distill it into a clear, concise executive summary (3-5 key bullet points). Highlight only the most important takeaways. End with a one-sentence conclusion.',\n        } as AgentNodeData,\n        label: 'Summarizer',\n      },\n      {\n        id: 'end_1',\n        type: 'end',\n        position: { x: 840, y: 200 },\n        data: {} as EndNodeData,\n        label: 'End',\n      },\n    ],\n    [\n      {\n        id: 'e1',\n        source: 'start_1',\n        target: 'agent_research',\n        type: 'sequence',\n      },\n      {\n        id: 'e2',\n        source: 'agent_research',\n        target: 'agent_summarize',\n        type: 'sequence',\n      },\n      {\n        id: 'e3',\n        source: 'agent_summarize',\n        target: 'end_1',\n        type: 'sequence',\n      },\n    ],\n  ),\n\n  // 4. Kubernetes Assistant — MCP tool integration\n  template(\n    'tpl-k8s-assistant',\n    'Kubernetes Assistant',\n    'Connects to a Kubernetes MCP server for live cluster operations — list pods, namespaces, deployments, and more.',\n    [\n      {\n        id: 'start_1',\n        type: 'start',\n        position: { x: 50, y: 200 },\n        data: {\n          inputDescription: 'Kubernetes question or command',\n        } as StartNodeData,\n        label: 'Start',\n      },\n      {\n        id: 'mcp_1',\n        type: 'mcp',\n        position: { x: 300, y: 200 },\n        data: {\n          serverUrl:\n            'https://kubernetes-mcp-server-ocp-mcp-server.apps.ocp.v7hjl.sandbox2288.opentlc.com',\n          serverLabel: 'k8s',\n          requireApproval: 'never',\n        } as McpNodeData,\n        label: 'K8s MCP Server',\n      },\n      {\n        id: 'agent_1',\n        type: 'agent',\n        position: { x: 580, y: 200 },\n        data: {\n          name: 'K8s Assistant',\n          instructions:\n            \"You are a Kubernetes expert assistant with access to a live cluster. Use the available MCP tools to query the cluster and answer the user's question. Format output clearly using markdown tables or lists. Always show the namespace and resource name.\",\n        } as AgentNodeData,\n        label: 'K8s Assistant',\n      },\n      {\n        id: 'end_1',\n        type: 'end',\n        position: { x: 840, y: 200 },\n        data: {} as EndNodeData,\n        label: 'End',\n      },\n    ],\n    [\n      { id: 'e1', source: 'start_1', target: 'mcp_1', type: 'sequence' },\n      { id: 'e2', source: 'mcp_1', target: 'agent_1', type: 'sequence' },\n      { id: 'e3', source: 'agent_1', target: 'end_1', type: 'sequence' },\n    ],\n  ),\n\n  // 5. Content Moderator — set_state + transform + agent pipeline\n  template(\n    'tpl-content-moderator',\n    'Content Moderator',\n    'Demonstrates data flow: sets metadata via state, transforms it into context, then an agent uses that context to moderate content.',\n    [\n      {\n        id: 'start_1',\n        type: 'start',\n        position: { x: 50, y: 200 },\n        data: { inputDescription: 'Content to moderate' } as StartNodeData,\n        label: 'Start',\n      },\n      {\n        id: 'set_state_1',\n        type: 'set_state',\n        position: { x: 280, y: 200 },\n        data: {\n          assignments: {\n            content_type: \"'user_generated'\",\n            platform: \"'public_forum'\",\n            policy_version: \"'v2.1'\",\n          },\n        } as SetStateNodeData,\n        label: 'Set Metadata',\n      },\n      {\n        id: 'transform_1',\n        type: 'transform',\n        position: { x: 520, y: 200 },\n        data: {\n          expression:\n            '`Content type: ${content_type}, Platform: ${platform}, Policy: ${policy_version}`',\n          outputVariable: 'moderation_context',\n        } as TransformNodeData,\n        label: 'Build Context',\n      },\n      {\n        id: 'agent_1',\n        type: 'agent',\n        position: { x: 780, y: 200 },\n        data: {\n          name: 'Moderator',\n          instructions:\n            'You are a content moderation specialist. Review the user-submitted content for policy violations. Consider the moderation context (content type, platform, policy version). Respond with:\\n1. **Verdict**: APPROVE or FLAG\\n2. **Reason**: Brief explanation\\n3. **Category**: If flagged, specify (spam, hate speech, harassment, misinformation, other)\\n4. **Confidence**: High / Medium / Low',\n        } as AgentNodeData,\n        label: 'Moderator',\n      },\n      {\n        id: 'end_1',\n        type: 'end',\n        position: { x: 1040, y: 200 },\n        data: {} as EndNodeData,\n        label: 'End',\n      },\n    ],\n    [\n      { id: 'e1', source: 'start_1', target: 'set_state_1', type: 'sequence' },\n      {\n        id: 'e2',\n        source: 'set_state_1',\n        target: 'transform_1',\n        type: 'sequence',\n      },\n      { id: 'e3', source: 'transform_1', target: 'agent_1', type: 'sequence' },\n      { id: 'e4', source: 'agent_1', target: 'end_1', type: 'sequence' },\n    ],\n  ),\n];\n"],"names":[],"mappings":"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"}