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

package/dist/templates/workflowTemplates.esm.js

@@ -0,0 +1,331 @@
+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" }
+    ]
+  )
+];
+
+export { WORKFLOW_TEMPLATES };
+//# sourceMappingURL=workflowTemplates.esm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflowTemplates.esm.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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"}

package/dist/types/branding.cjs.js

@@ -0,0 +1,17 @@
+'use strict';
+
+const DEFAULT_BRANDING = {
+  appName: "Augment",
+  tagline: "Your AI-powered platform assistant",
+  inputPlaceholder: "Ask me anything...",
+  primaryColor: "#1e40af",
+  secondaryColor: "#475569",
+  successColor: "#10b981",
+  warningColor: "#f59e0b",
+  errorColor: "#ef4444",
+  infoColor: "#0ea5e9",
+  themePreset: "default"
+};
+
+exports.DEFAULT_BRANDING = DEFAULT_BRANDING;
+//# sourceMappingURL=branding.cjs.js.map

package/dist/types/branding.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.cjs.js","sources":["../../src/types/branding.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\n/**\n * Branding configuration loaded from app-config.yaml.\n * Shared across frontend and backend.\n * @public\n */\nexport interface BrandingConfig {\n  appName: string;\n  tagline: string;\n  inputPlaceholder: string;\n  primaryColor: string;\n  secondaryColor: string;\n  successColor: string;\n  warningColor: string;\n  errorColor: string;\n  infoColor: string;\n  logoUrl?: string;\n  faviconUrl?: string;\n  botAvatarUrl?: string;\n  themePreset?: string;\n}\n\n/**\n * Single source of truth for branding defaults.\n * Used by both frontend hooks and backend API routes.\n * @public\n */\nexport const DEFAULT_BRANDING: BrandingConfig = {\n  appName: 'Augment',\n  tagline: 'Your AI-powered platform assistant',\n  inputPlaceholder: 'Ask me anything...',\n  primaryColor: '#1e40af',\n  secondaryColor: '#475569',\n  successColor: '#10b981',\n  warningColor: '#f59e0b',\n  errorColor: '#ef4444',\n  infoColor: '#0ea5e9',\n  themePreset: 'default',\n};\n"],"names":[],"mappings":";;AA0CO,MAAM,gBAAA,GAAmC;AAAA,EAC9C,OAAA,EAAS,SAAA;AAAA,EACT,OAAA,EAAS,oCAAA;AAAA,EACT,gBAAA,EAAkB,oBAAA;AAAA,EAClB,YAAA,EAAc,SAAA;AAAA,EACd,cAAA,EAAgB,SAAA;AAAA,EAChB,YAAA,EAAc,SAAA;AAAA,EACd,YAAA,EAAc,SAAA;AAAA,EACd,UAAA,EAAY,SAAA;AAAA,EACZ,SAAA,EAAW,SAAA;AAAA,EACX,WAAA,EAAa;AACf;;;;"}

package/dist/types/branding.esm.js

@@ -0,0 +1,15 @@
+const DEFAULT_BRANDING = {
+  appName: "Augment",
+  tagline: "Your AI-powered platform assistant",
+  inputPlaceholder: "Ask me anything...",
+  primaryColor: "#1e40af",
+  secondaryColor: "#475569",
+  successColor: "#10b981",
+  warningColor: "#f59e0b",
+  errorColor: "#ef4444",
+  infoColor: "#0ea5e9",
+  themePreset: "default"
+};
+
+export { DEFAULT_BRANDING };
+//# sourceMappingURL=branding.esm.js.map

package/dist/types/branding.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.esm.js","sources":["../../src/types/branding.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\n/**\n * Branding configuration loaded from app-config.yaml.\n * Shared across frontend and backend.\n * @public\n */\nexport interface BrandingConfig {\n  appName: string;\n  tagline: string;\n  inputPlaceholder: string;\n  primaryColor: string;\n  secondaryColor: string;\n  successColor: string;\n  warningColor: string;\n  errorColor: string;\n  infoColor: string;\n  logoUrl?: string;\n  faviconUrl?: string;\n  botAvatarUrl?: string;\n  themePreset?: string;\n}\n\n/**\n * Single source of truth for branding defaults.\n * Used by both frontend hooks and backend API routes.\n * @public\n */\nexport const DEFAULT_BRANDING: BrandingConfig = {\n  appName: 'Augment',\n  tagline: 'Your AI-powered platform assistant',\n  inputPlaceholder: 'Ask me anything...',\n  primaryColor: '#1e40af',\n  secondaryColor: '#475569',\n  successColor: '#10b981',\n  warningColor: '#f59e0b',\n  errorColor: '#ef4444',\n  infoColor: '#0ea5e9',\n  themePreset: 'default',\n};\n"],"names":[],"mappings":"AA0CO,MAAM,gBAAA,GAAmC;AAAA,EAC9C,OAAA,EAAS,SAAA;AAAA,EACT,OAAA,EAAS,oCAAA;AAAA,EACT,gBAAA,EAAkB,oBAAA;AAAA,EAClB,YAAA,EAAc,SAAA;AAAA,EACd,cAAA,EAAgB,SAAA;AAAA,EAChB,YAAA,EAAc,SAAA;AAAA,EACd,YAAA,EAAc,SAAA;AAAA,EACd,UAAA,EAAY,SAAA;AAAA,EACZ,SAAA,EAAW,SAAA;AAAA,EACX,WAAA,EAAa;AACf;;;;"}

package/dist/types/provider.cjs.js

@@ -0,0 +1,52 @@
+'use strict';
+
+const GLOBAL_CONFIG_KEYS = [
+  "systemPrompt",
+  "branding",
+  "promptGroups",
+  "safetyPatterns",
+  "mcpServers",
+  "disabledMcpServerIds",
+  "agents",
+  "defaultAgent",
+  "maxAgentTurns",
+  "devSpacesApiUrl"
+];
+const PROVIDER_SCOPED_KEYS = [
+  "model",
+  "baseUrl",
+  "kagentiBaseUrl",
+  "toolChoice",
+  "enableWebSearch",
+  "enableCodeInterpreter",
+  "safetyEnabled",
+  "inputShields",
+  "outputShields",
+  "safetyOnError",
+  "evaluationEnabled",
+  "scoringFunctions",
+  "minScoreThreshold",
+  "evaluationOnError",
+  "vectorStoreConfig",
+  "activeVectorStoreIds",
+  "maxToolCalls",
+  "maxOutputTokens",
+  "temperature",
+  "safetyIdentifier"
+];
+function scopedConfigKey(provider, key) {
+  return `${provider}::${key}`;
+}
+function isProviderScopedKey(key) {
+  return PROVIDER_SCOPED_KEYS.includes(key);
+}
+function isGlobalConfigKey(key) {
+  return GLOBAL_CONFIG_KEYS.includes(key);
+}
+
+exports.GLOBAL_CONFIG_KEYS = GLOBAL_CONFIG_KEYS;
+exports.PROVIDER_SCOPED_KEYS = PROVIDER_SCOPED_KEYS;
+exports.isGlobalConfigKey = isGlobalConfigKey;
+exports.isProviderScopedKey = isProviderScopedKey;
+exports.scopedConfigKey = scopedConfigKey;
+//# sourceMappingURL=provider.cjs.js.map

package/dist/types/provider.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.cjs.js","sources":["../../src/types/provider.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\n// =============================================================================\n// Provider Types\n// =============================================================================\n\n/**\n * Built-in AI provider identifiers shipped with the plugin.\n * @public\n */\nexport type BuiltInProviderType = 'llamastack' | 'googleadk' | 'kagenti';\n\n/**\n * All accepted provider identifiers.\n *\n * Built-in types (`llamastack`, `googleadk`) are autocompleted,\n * but arbitrary string IDs from extension-registered providers\n * are also accepted via the `(string & {})` widening pattern.\n *\n * @public\n */\nexport type ProviderType = BuiltInProviderType | (string & {});\n\n/**\n * Capability categories that a provider may support.\n *\n * Used by the admin panel to conditionally render config tabs\n * and by the backend to gate API endpoints.\n *\n * @public\n */\nexport interface ProviderCapabilities {\n  readonly chat: boolean;\n  readonly rag: boolean;\n  readonly safety: boolean;\n  readonly evaluation: boolean;\n  readonly conversations: boolean;\n  readonly mcpTools: boolean;\n  readonly tools: boolean;\n  /** Provider manages tool lifecycle (build, deploy, route) */\n  readonly toolLifecycle: boolean;\n  /** Provider manages agent lifecycle (build, deploy, migrate) */\n  readonly agentLifecycle: boolean;\n  /** Provider supports DevSpaces integration */\n  readonly devSpaces: boolean;\n  /** Provider needs context hydrated from DB on non-streaming paths */\n  readonly contextHydration: boolean;\n  /** Provider registers its own sub-routes (e.g. kagenti-specific endpoints) */\n  readonly providerRoutes: boolean;\n}\n\n/**\n * Definition of a single provider-specific config field.\n *\n * The admin panel uses these to render dynamic forms based\n * on which provider is active.\n *\n * @public\n */\nexport interface ProviderConfigField {\n  /** Config key (matches AdminConfigKey) */\n  readonly key: string;\n  /** Human-readable label for the form field */\n  readonly label: string;\n  /** Field type determines the form control rendered */\n  readonly type: 'string' | 'boolean' | 'number' | 'select';\n  /** Whether the field is required for the provider to function */\n  readonly required: boolean;\n  /** Help text shown below the field */\n  readonly description?: string;\n  /** Options for 'select' type fields */\n  readonly options?: readonly string[];\n  /** Placeholder text for text inputs */\n  readonly placeholder?: string;\n  /** Whether the field value is sensitive (passwords, secrets) and should be masked in UI */\n  readonly sensitive?: boolean;\n}\n\n/**\n * Describes an AI provider's identity, capabilities, and config shape.\n *\n * The provider registry holds one descriptor per known provider,\n * including placeholders for providers that are not yet implemented.\n *\n * @public\n */\nexport interface ProviderDescriptor {\n  /** Unique provider identifier */\n  readonly id: ProviderType;\n  /** Human-readable display name (e.g., \"Llama Stack\") */\n  readonly displayName: string;\n  /** Short description of the provider */\n  readonly description: string;\n  /** Whether this provider has a working implementation */\n  readonly implemented: boolean;\n  /** Which capability categories this provider supports */\n  readonly capabilities: ProviderCapabilities;\n  /** Provider-specific config field definitions for the admin panel */\n  readonly configFields: readonly ProviderConfigField[];\n}\n\n// =============================================================================\n// Config Key Scoping\n// =============================================================================\n\n/**\n * Config keys that are shared across all providers.\n *\n * These are stored without a provider prefix and apply\n * regardless of which provider is active.\n *\n * @public\n */\nexport const GLOBAL_CONFIG_KEYS = [\n  'systemPrompt',\n  'branding',\n  'promptGroups',\n  'safetyPatterns',\n  'mcpServers',\n  'disabledMcpServerIds',\n  'agents',\n  'defaultAgent',\n  'maxAgentTurns',\n  'devSpacesApiUrl',\n] as const;\n\n/**\n * Config keys that are scoped per provider.\n *\n * When stored in the database, these are prefixed with the\n * provider ID (e.g., `llamastack::model`). This allows each\n * provider to retain its own settings when switching.\n *\n * @public\n */\nexport const PROVIDER_SCOPED_KEYS = [\n  'model',\n  'baseUrl',\n  'kagentiBaseUrl',\n  'toolChoice',\n  'enableWebSearch',\n  'enableCodeInterpreter',\n  'safetyEnabled',\n  'inputShields',\n  'outputShields',\n  'safetyOnError',\n  'evaluationEnabled',\n  'scoringFunctions',\n  'minScoreThreshold',\n  'evaluationOnError',\n  'vectorStoreConfig',\n  'activeVectorStoreIds',\n  'maxToolCalls',\n  'maxOutputTokens',\n  'temperature',\n  'safetyIdentifier',\n] as const;\n\n/**\n * Type-safe element of {@link GLOBAL_CONFIG_KEYS}.\n * @public\n */\nexport type GlobalConfigKey = (typeof GLOBAL_CONFIG_KEYS)[number];\n\n/**\n * Type-safe element of {@link PROVIDER_SCOPED_KEYS}.\n * @public\n */\nexport type ProviderScopedKey = (typeof PROVIDER_SCOPED_KEYS)[number];\n\n/**\n * Build a provider-scoped config key for database storage.\n *\n * @param provider - The provider ID to scope under\n * @param key - The base config key\n * @returns A scoped key in the format `provider::key`\n * @public\n */\nexport function scopedConfigKey(provider: ProviderType, key: string): string {\n  return `${provider}::${key}`;\n}\n\n/**\n * Check whether a config key is provider-scoped.\n *\n * @param key - The config key to check\n * @returns `true` if the key should be stored per-provider\n * @public\n */\nexport function isProviderScopedKey(key: string): key is ProviderScopedKey {\n  return (PROVIDER_SCOPED_KEYS as readonly string[]).includes(key);\n}\n\n/**\n * Check whether a config key is global (shared across providers).\n *\n * @param key - The config key to check\n * @returns `true` if the key is shared across all providers\n * @public\n */\nexport function isGlobalConfigKey(key: string): key is GlobalConfigKey {\n  return (GLOBAL_CONFIG_KEYS as readonly string[]).includes(key);\n}\n"],"names":[],"mappings":";;AA+HO,MAAM,kBAAA,GAAqB;AAAA,EAChC,cAAA;AAAA,EACA,UAAA;AAAA,EACA,cAAA;AAAA,EACA,gBAAA;AAAA,EACA,YAAA;AAAA,EACA,sBAAA;AAAA,EACA,QAAA;AAAA,EACA,cAAA;AAAA,EACA,eAAA;AAAA,EACA;AACF;AAWO,MAAM,oBAAA,GAAuB;AAAA,EAClC,OAAA;AAAA,EACA,SAAA;AAAA,EACA,gBAAA;AAAA,EACA,YAAA;AAAA,EACA,iBAAA;AAAA,EACA,uBAAA;AAAA,EACA,eAAA;AAAA,EACA,cAAA;AAAA,EACA,eAAA;AAAA,EACA,eAAA;AAAA,EACA,mBAAA;AAAA,EACA,kBAAA;AAAA,EACA,mBAAA;AAAA,EACA,mBAAA;AAAA,EACA,mBAAA;AAAA,EACA,sBAAA;AAAA,EACA,cAAA;AAAA,EACA,iBAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF;AAsBO,SAAS,eAAA,CAAgB,UAAwB,GAAA,EAAqB;AAC3E,EAAA,OAAO,CAAA,EAAG,QAAQ,CAAA,EAAA,EAAK,GAAG,CAAA,CAAA;AAC5B;AASO,SAAS,oBAAoB,GAAA,EAAuC;AACzE,EAAA,OAAQ,oBAAA,CAA2C,SAAS,GAAG,CAAA;AACjE;AASO,SAAS,kBAAkB,GAAA,EAAqC;AACrE,EAAA,OAAQ,kBAAA,CAAyC,SAAS,GAAG,CAAA;AAC/D;;;;;;;;"}

package/dist/types/provider.esm.js

@@ -0,0 +1,46 @@
+const GLOBAL_CONFIG_KEYS = [
+  "systemPrompt",
+  "branding",
+  "promptGroups",
+  "safetyPatterns",
+  "mcpServers",
+  "disabledMcpServerIds",
+  "agents",
+  "defaultAgent",
+  "maxAgentTurns",
+  "devSpacesApiUrl"
+];
+const PROVIDER_SCOPED_KEYS = [
+  "model",
+  "baseUrl",
+  "kagentiBaseUrl",
+  "toolChoice",
+  "enableWebSearch",
+  "enableCodeInterpreter",
+  "safetyEnabled",
+  "inputShields",
+  "outputShields",
+  "safetyOnError",
+  "evaluationEnabled",
+  "scoringFunctions",
+  "minScoreThreshold",
+  "evaluationOnError",
+  "vectorStoreConfig",
+  "activeVectorStoreIds",
+  "maxToolCalls",
+  "maxOutputTokens",
+  "temperature",
+  "safetyIdentifier"
+];
+function scopedConfigKey(provider, key) {
+  return `${provider}::${key}`;
+}
+function isProviderScopedKey(key) {
+  return PROVIDER_SCOPED_KEYS.includes(key);
+}
+function isGlobalConfigKey(key) {
+  return GLOBAL_CONFIG_KEYS.includes(key);
+}
+
+export { GLOBAL_CONFIG_KEYS, PROVIDER_SCOPED_KEYS, isGlobalConfigKey, isProviderScopedKey, scopedConfigKey };
+//# sourceMappingURL=provider.esm.js.map

package/dist/types/provider.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.esm.js","sources":["../../src/types/provider.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\n// =============================================================================\n// Provider Types\n// =============================================================================\n\n/**\n * Built-in AI provider identifiers shipped with the plugin.\n * @public\n */\nexport type BuiltInProviderType = 'llamastack' | 'googleadk' | 'kagenti';\n\n/**\n * All accepted provider identifiers.\n *\n * Built-in types (`llamastack`, `googleadk`) are autocompleted,\n * but arbitrary string IDs from extension-registered providers\n * are also accepted via the `(string & {})` widening pattern.\n *\n * @public\n */\nexport type ProviderType = BuiltInProviderType | (string & {});\n\n/**\n * Capability categories that a provider may support.\n *\n * Used by the admin panel to conditionally render config tabs\n * and by the backend to gate API endpoints.\n *\n * @public\n */\nexport interface ProviderCapabilities {\n  readonly chat: boolean;\n  readonly rag: boolean;\n  readonly safety: boolean;\n  readonly evaluation: boolean;\n  readonly conversations: boolean;\n  readonly mcpTools: boolean;\n  readonly tools: boolean;\n  /** Provider manages tool lifecycle (build, deploy, route) */\n  readonly toolLifecycle: boolean;\n  /** Provider manages agent lifecycle (build, deploy, migrate) */\n  readonly agentLifecycle: boolean;\n  /** Provider supports DevSpaces integration */\n  readonly devSpaces: boolean;\n  /** Provider needs context hydrated from DB on non-streaming paths */\n  readonly contextHydration: boolean;\n  /** Provider registers its own sub-routes (e.g. kagenti-specific endpoints) */\n  readonly providerRoutes: boolean;\n}\n\n/**\n * Definition of a single provider-specific config field.\n *\n * The admin panel uses these to render dynamic forms based\n * on which provider is active.\n *\n * @public\n */\nexport interface ProviderConfigField {\n  /** Config key (matches AdminConfigKey) */\n  readonly key: string;\n  /** Human-readable label for the form field */\n  readonly label: string;\n  /** Field type determines the form control rendered */\n  readonly type: 'string' | 'boolean' | 'number' | 'select';\n  /** Whether the field is required for the provider to function */\n  readonly required: boolean;\n  /** Help text shown below the field */\n  readonly description?: string;\n  /** Options for 'select' type fields */\n  readonly options?: readonly string[];\n  /** Placeholder text for text inputs */\n  readonly placeholder?: string;\n  /** Whether the field value is sensitive (passwords, secrets) and should be masked in UI */\n  readonly sensitive?: boolean;\n}\n\n/**\n * Describes an AI provider's identity, capabilities, and config shape.\n *\n * The provider registry holds one descriptor per known provider,\n * including placeholders for providers that are not yet implemented.\n *\n * @public\n */\nexport interface ProviderDescriptor {\n  /** Unique provider identifier */\n  readonly id: ProviderType;\n  /** Human-readable display name (e.g., \"Llama Stack\") */\n  readonly displayName: string;\n  /** Short description of the provider */\n  readonly description: string;\n  /** Whether this provider has a working implementation */\n  readonly implemented: boolean;\n  /** Which capability categories this provider supports */\n  readonly capabilities: ProviderCapabilities;\n  /** Provider-specific config field definitions for the admin panel */\n  readonly configFields: readonly ProviderConfigField[];\n}\n\n// =============================================================================\n// Config Key Scoping\n// =============================================================================\n\n/**\n * Config keys that are shared across all providers.\n *\n * These are stored without a provider prefix and apply\n * regardless of which provider is active.\n *\n * @public\n */\nexport const GLOBAL_CONFIG_KEYS = [\n  'systemPrompt',\n  'branding',\n  'promptGroups',\n  'safetyPatterns',\n  'mcpServers',\n  'disabledMcpServerIds',\n  'agents',\n  'defaultAgent',\n  'maxAgentTurns',\n  'devSpacesApiUrl',\n] as const;\n\n/**\n * Config keys that are scoped per provider.\n *\n * When stored in the database, these are prefixed with the\n * provider ID (e.g., `llamastack::model`). This allows each\n * provider to retain its own settings when switching.\n *\n * @public\n */\nexport const PROVIDER_SCOPED_KEYS = [\n  'model',\n  'baseUrl',\n  'kagentiBaseUrl',\n  'toolChoice',\n  'enableWebSearch',\n  'enableCodeInterpreter',\n  'safetyEnabled',\n  'inputShields',\n  'outputShields',\n  'safetyOnError',\n  'evaluationEnabled',\n  'scoringFunctions',\n  'minScoreThreshold',\n  'evaluationOnError',\n  'vectorStoreConfig',\n  'activeVectorStoreIds',\n  'maxToolCalls',\n  'maxOutputTokens',\n  'temperature',\n  'safetyIdentifier',\n] as const;\n\n/**\n * Type-safe element of {@link GLOBAL_CONFIG_KEYS}.\n * @public\n */\nexport type GlobalConfigKey = (typeof GLOBAL_CONFIG_KEYS)[number];\n\n/**\n * Type-safe element of {@link PROVIDER_SCOPED_KEYS}.\n * @public\n */\nexport type ProviderScopedKey = (typeof PROVIDER_SCOPED_KEYS)[number];\n\n/**\n * Build a provider-scoped config key for database storage.\n *\n * @param provider - The provider ID to scope under\n * @param key - The base config key\n * @returns A scoped key in the format `provider::key`\n * @public\n */\nexport function scopedConfigKey(provider: ProviderType, key: string): string {\n  return `${provider}::${key}`;\n}\n\n/**\n * Check whether a config key is provider-scoped.\n *\n * @param key - The config key to check\n * @returns `true` if the key should be stored per-provider\n * @public\n */\nexport function isProviderScopedKey(key: string): key is ProviderScopedKey {\n  return (PROVIDER_SCOPED_KEYS as readonly string[]).includes(key);\n}\n\n/**\n * Check whether a config key is global (shared across providers).\n *\n * @param key - The config key to check\n * @returns `true` if the key is shared across all providers\n * @public\n */\nexport function isGlobalConfigKey(key: string): key is GlobalConfigKey {\n  return (GLOBAL_CONFIG_KEYS as readonly string[]).includes(key);\n}\n"],"names":[],"mappings":"AA+HO,MAAM,kBAAA,GAAqB;AAAA,EAChC,cAAA;AAAA,EACA,UAAA;AAAA,EACA,cAAA;AAAA,EACA,gBAAA;AAAA,EACA,YAAA;AAAA,EACA,sBAAA;AAAA,EACA,QAAA;AAAA,EACA,cAAA;AAAA,EACA,eAAA;AAAA,EACA;AACF;AAWO,MAAM,oBAAA,GAAuB;AAAA,EAClC,OAAA;AAAA,EACA,SAAA;AAAA,EACA,gBAAA;AAAA,EACA,YAAA;AAAA,EACA,iBAAA;AAAA,EACA,uBAAA;AAAA,EACA,eAAA;AAAA,EACA,cAAA;AAAA,EACA,eAAA;AAAA,EACA,eAAA;AAAA,EACA,mBAAA;AAAA,EACA,kBAAA;AAAA,EACA,mBAAA;AAAA,EACA,mBAAA;AAAA,EACA,mBAAA;AAAA,EACA,sBAAA;AAAA,EACA,cAAA;AAAA,EACA,iBAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF;AAsBO,SAAS,eAAA,CAAgB,UAAwB,GAAA,EAAqB;AAC3E,EAAA,OAAO,CAAA,EAAG,QAAQ,CAAA,EAAA,EAAK,GAAG,CAAA,CAAA;AAC5B;AASO,SAAS,oBAAoB,GAAA,EAAuC;AACzE,EAAA,OAAQ,oBAAA,CAA2C,SAAS,GAAG,CAAA;AACjE;AASO,SAAS,kBAAkB,GAAA,EAAqC;AACrE,EAAA,OAAQ,kBAAA,CAAyC,SAAS,GAAG,CAAA;AAC/D;;;;"}

package/dist/types/shared.cjs.js

@@ -0,0 +1,86 @@
+'use strict';
+
+var FileFormat = /* @__PURE__ */ ((FileFormat2) => {
+  FileFormat2["YAML"] = "yaml";
+  FileFormat2["PDF"] = "pdf";
+  FileFormat2["TEXT"] = "text";
+  FileFormat2["MARKDOWN"] = "markdown";
+  FileFormat2["JSON"] = "json";
+  return FileFormat2;
+})(FileFormat || {});
+const LIFECYCLE_STAGE_ORDER = [
+  "draft",
+  "pending",
+  "published",
+  "archived"
+];
+const LIFECYCLE_TRANSITIONS = [
+  {
+    from: "draft",
+    to: "pending",
+    action: "submit",
+    label: "Submit for Review"
+  },
+  {
+    from: "pending",
+    to: "published",
+    action: "approve",
+    label: "Approve and Publish"
+  },
+  { from: "pending", to: "draft", action: "reject", label: "Reject" },
+  { from: "pending", to: "draft", action: "withdraw", label: "Withdraw" },
+  {
+    from: "published",
+    to: "pending",
+    action: "request-unpublish",
+    label: "Request Unpublish"
+  },
+  { from: "published", to: "archived", action: "archive", label: "Archive" },
+  { from: "archived", to: "draft", action: "reactivate", label: "Reactivate" }
+];
+const LEGACY_STAGE_MAP = {
+  registered: "pending",
+  deployed: "published",
+  review: "pending",
+  staging: "pending",
+  production: "published",
+  retired: "archived"
+};
+function getAvailableTransitions(stage) {
+  return LIFECYCLE_TRANSITIONS.filter((t) => t.from === stage);
+}
+function isValidTransition(from, to) {
+  return LIFECYCLE_TRANSITIONS.some((t) => t.from === from && t.to === to);
+}
+function normalizeLifecycleStage(stage) {
+  if (!stage) return "draft";
+  const trimmed = stage.trim().toLocaleLowerCase("en-US");
+  if (!trimmed) return "draft";
+  if (Object.hasOwn(LEGACY_STAGE_MAP, trimmed))
+    return LEGACY_STAGE_MAP[trimmed];
+  if (LIFECYCLE_STAGE_ORDER.includes(trimmed)) {
+    return trimmed;
+  }
+  return "draft";
+}
+function deriveRoleFromTopology(agentKey, allAgents) {
+  const agent = allAgents[agentKey];
+  if (!agent) return "standalone";
+  const hasOutgoing = agent.handoffs && agent.handoffs.length > 0 || agent.asTools && agent.asTools.length > 0;
+  if (hasOutgoing) return "router";
+  const isTarget = Object.entries(allAgents).some(
+    ([k, a]) => k !== agentKey && a !== null && a !== void 0 && ((a.handoffs ?? []).includes(agentKey) || (a.asTools ?? []).includes(agentKey))
+  );
+  if (isTarget) return "specialist";
+  return "standalone";
+}
+
+exports.FileFormat = FileFormat;
+exports.LEGACY_STAGE_MAP = LEGACY_STAGE_MAP;
+exports.LIFECYCLE_STAGE_ORDER = LIFECYCLE_STAGE_ORDER;
+exports.LIFECYCLE_TRANSITIONS = LIFECYCLE_TRANSITIONS;
+exports.deriveRoleFromTopology = deriveRoleFromTopology;
+exports.getAvailableTransitions = getAvailableTransitions;
+exports.isValidTransition = isValidTransition;
+exports.normalizeLifecycleStage = normalizeLifecycleStage;
+//# sourceMappingURL=shared.cjs.js.map