@newsails/veil-studio 1.0.0

package/server/utils/elements/agent-instance.js

@@ -0,0 +1,62 @@
+'use strict'
+
+module.exports = {
+  type:          'agent-instance',
+  name:          'Agent Instance',
+  description:   'An active chat session with a VeilCLI agent.',
+  icon:          'message-circle',
+  defaultWidth:  180,
+  defaultHeight: 90,
+  expansionMode: 'sidebar',
+  tags:              ['cli', 'agent', 'chat'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element, log } = context
+    let _isStreaming = false
+
+    return {
+      getViewData() {
+        return {
+          agentName:   element.data.agentName  || null,
+          sessionId:   element.data.sessionId  || null,
+          isStreaming: _isStreaming,
+        }
+      },
+
+      getPorts() {
+        return [
+          { key: 'msg-in',  direction: 'input',  dataType: 'text', label: 'Message In' },
+          { key: 'msg-out', direction: 'output', dataType: 'text', label: 'Message Out' },
+        ]
+      },
+
+      actions: {
+        setStreaming({ streaming }) {
+          _isStreaming = !!streaming
+        },
+
+        openChat(_params) {
+          // Handled client-side by useChat.ts
+          log('openChat action (client-side)')
+        },
+
+        async ensureSession(_params) {
+          if (element.data.sessionId) return
+          const { veil } = context
+          const agentName = element.data.agentName
+          if (!agentName) throw new Error('No agent name set')
+          try {
+            const session = await veil.post('/sessions', { agent: agentName })
+            const { updateElement } = require('../board-state.js')
+            updateElement(element.id, { data: { ...element.data, sessionId: session.id } })
+          } catch (err) {
+            log(`Failed to create session: ${err.message}`)
+            throw err
+          }
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/agent.js

@@ -0,0 +1,93 @@
+'use strict'
+
+module.exports = {
+  type:          'agent',
+  name:          'Agent',
+  description:   'A VeilCLI agent definition. Open a session to start chatting.',
+  icon:          'bot',
+  defaultWidth:  240,
+  defaultHeight: 130,
+  expansionMode: 'popup',
+  tags:              ['cli', 'agent'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element, veil, emit, log } = context
+
+    return {
+      getViewData() {
+        const name        = element.data.name || element.data.agentName || null
+        const agentInfo   = element.data.agentInfo || {}
+        return {
+          name,
+          agentName:   name,
+          model:       element.data.model       || agentInfo.model       || null,
+          description: element.data.description || agentInfo.description || null,
+          modes:       element.data.modes       || agentInfo.modes       || null,
+          source:      element.data.source      || agentInfo.source      || null,
+        }
+      },
+
+      getPorts() {
+        return [
+          { key: 'instances', direction: 'output', dataType: 'agent', label: 'Instances' },
+        ]
+      },
+
+      actions: {
+        async openSession(_params) {
+          const { createElement } = require('../board-state.js')
+          const { createInstance, getViewData, getPorts } = require('../element-instances.js')
+          const { getIO } = require('../socket-io.js')
+
+          const agentName = element.data.name || element.data.agentName
+          if (!agentName) throw new Error('No agent name set on this element')
+
+          log(`Creating Veil session for agent "${agentName}"`)
+          let sessionId = null
+          try {
+            const res = await veil.post('/sessions', { agentName })
+            sessionId = res.sessionId
+            log(`Session created: ${sessionId}`)
+          } catch (err) {
+            log(`Failed to create session: ${err.message}`)
+            throw new Error(`Could not create session: ${err.message}`)
+          }
+
+          const newEl = createElement({
+            type:   'agent-instance',
+            x:      element.x + 200,
+            y:      element.y,
+            width:  180,
+            height: 110,
+            data:   { agentName, sessionId },
+          })
+
+          createInstance(newEl)
+          const viewData = getViewData(newEl.id)
+          const ports    = getPorts(newEl.id)
+          getIO().to('board').emit('board:delta', {
+            type:     'element:view',
+            id:       newEl.id,
+            viewData: { ...viewData, ports },
+          })
+
+          return { sessionId, elementId: newEl.id }
+        },
+
+        async refreshAgent(_params) {
+          const agentName = element.data.agentName
+          if (!agentName) return
+          try {
+            const agent = await veil.get(`/agents/${encodeURIComponent(agentName)}`)
+            const { updateElement } = require('../board-state.js')
+            updateElement(element.id, { data: { ...element.data, agentInfo: agent } })
+          } catch (err) {
+            log(`Failed to refresh agent: ${err.message}`)
+          }
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/annotation.js

@@ -0,0 +1,30 @@
+'use strict'
+
+module.exports = {
+  type:          'annotation',
+  name:          'Annotation',
+  description:   'A floating note that follows its target element.',
+  icon:          'sticky-note',
+  defaultWidth:  180,
+  defaultHeight: 80,
+  expansionMode: 'inline',
+  tags:          ['org'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return { text: element.data.text || '', targetId: element.data.targetId || null }
+      },
+      getPorts() { return [] },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/approval-gate.js

@@ -0,0 +1,49 @@
+'use strict'
+
+module.exports = {
+  type:          'approval-gate',
+  name:          'Approval Gate',
+  description:   'Gate flow on an approve/reject decision.',
+  icon:          'shield-check',
+  defaultWidth:  220,
+  defaultHeight: 90,
+  expansionMode: 'inline',
+  tags:          ['comm', 'flow'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          title:       element.data.title       || '',
+          description: element.data.description || '',
+          status:      element.data.status      || 'pending',
+          reason:      element.data.reason      || null,
+        }
+      },
+      getPorts() {
+        return [
+          { key: 'item-in',      direction: 'input',  dataType: 'any',  label: 'Item In' },
+          { key: 'approved-out', direction: 'output', dataType: 'any',  label: 'Approved' },
+          { key: 'rejected-out', direction: 'output', dataType: 'any',  label: 'Rejected' },
+        ]
+      },
+      actions: {
+        approve(_params) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, status: 'approved', reason: null } })
+        },
+        reject({ reason } = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, status: 'rejected', reason: reason || null } })
+        },
+        reset(_params) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, status: 'pending', reason: null } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/assumption.js

@@ -0,0 +1,32 @@
+'use strict'
+
+module.exports = {
+  type:          'assumption',
+  name:          'Assumption',
+  description:   'An assumption that underlies a decision or plan.',
+  icon:          'quote',
+  defaultWidth:  180,
+  defaultHeight: 70,
+  expansionMode: 'inline',
+  tags:          ['thinking'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return { text: element.data.text || '', challenged: element.data.challenged || false }
+      },
+      getPorts() {
+        return [{ key: 'assumption-out', direction: 'output', dataType: 'text', label: 'Assumption Out' }]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/blocker.js

@@ -0,0 +1,36 @@
+'use strict'
+
+module.exports = {
+  type:          'blocker',
+  name:          'Blocker',
+  description:   'Track a blocker or impediment.',
+  icon:          'octagon',
+  defaultWidth:  200,
+  defaultHeight: 80,
+  expansionMode: 'inline',
+  tags:          ['thinking', 'pm'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          title:       element.data.title       || '',
+          description: element.data.description || '',
+          severity:    element.data.severity    || 'medium',
+        }
+      },
+      getPorts() {
+        return [{ key: 'blocker-out', direction: 'output', dataType: 'text', label: 'Blocker Out' }]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/chat-room.js

@@ -0,0 +1,47 @@
+'use strict'
+
+module.exports = {
+  type:          'chat-room',
+  name:          'Chat Room',
+  description:   'A multi-agent chat room.',
+  icon:          'messages-square',
+  defaultWidth:  240,
+  defaultHeight: 150,
+  expansionMode: 'popup',
+  tags:          ['comm'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element, emit } = context
+    return {
+      getViewData() {
+        return {
+          name:     element.data.name     || '',
+          messages: element.data.messages || [],
+        }
+      },
+      getPorts() {
+        return [
+          { key: 'agents-in',   direction: 'input',  dataType: 'agent', label: 'Agents In' },
+          { key: 'messages-out', direction: 'output', dataType: 'json',  label: 'Messages Out' },
+        ]
+      },
+      actions: {
+        postMessage({ role, content } = {}) {
+          const { updateElement } = require('../board-state.js')
+          const messages = [
+            ...(element.data.messages || []),
+            { role, content, timestamp: Date.now() },
+          ]
+          updateElement(element.id, { data: { ...element.data, messages } })
+          emit('element:view', { id: element.id, viewData: { messages } })
+        },
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/chat-view.js

@@ -0,0 +1,33 @@
+'use strict'
+
+module.exports = {
+  type:              'chat-view',
+  name:              'Chat View',
+  description:       'Inline chat panel for an agent session. Created automatically from an agent instance.',
+  icon:              '💬',
+  defaultWidth:      320,
+  defaultHeight:     440,
+  hiddenFromPalette: true,
+  tags:              ['cli'],
+  isBuiltIn:         true,
+
+  createInstance(context) {
+    const { element } = context
+    let _isStreaming = false
+    return {
+      getViewData() {
+        return {
+          agentName:   element.data.agentName || null,
+          sessionId:   element.data.sessionId || null,
+          isStreaming: _isStreaming,
+        }
+      },
+      getPorts() { return [] },
+      actions: {
+        setStreaming({ streaming }) {
+          _isStreaming = !!streaming
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/code-block.js

@@ -0,0 +1,39 @@
+'use strict'
+
+module.exports = {
+  type:          'code-block',
+  name:          'Code Block',
+  description:   'A syntax-highlighted code snippet.',
+  icon:          'code',
+  defaultWidth:  240,
+  defaultHeight: 120,
+  expansionMode: 'popup',
+  tags:          ['data', 'dev'],
+  isBuiltIn:     true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          code:     element.data.code || '',
+          language: element.data.language || 'text',
+          title:    element.data.title || '',
+        }
+      },
+      getPorts() {
+        return [{ key: 'code-out', direction: 'output', dataType: 'text', label: 'Code Out' }]
+      },
+      actions: {
+        update({ code, language, title } = {}) {
+          const { updateElement } = require('../board-state.js')
+          const data = { ...element.data }
+          if (code !== undefined)     data.code     = code
+          if (language !== undefined) data.language = language
+          if (title !== undefined)    data.title    = title
+          updateElement(element.id, { data })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/collapsible-group.js

@@ -0,0 +1,37 @@
+'use strict'
+
+module.exports = {
+  type:          'collapsible-group',
+  name:          'Collapsible Group',
+  description:   'A group that contains other elements and can be collapsed.',
+  icon:          'group',
+  defaultWidth:  300,
+  defaultHeight: 200,
+  expansionMode: 'inline',
+  tags:          ['org'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          label:     element.data.label     || '',
+          collapsed: element.data.collapsed || false,
+        }
+      },
+      getPorts() { return [] },
+      actions: {
+        toggle(_params) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, collapsed: !element.data.collapsed } })
+        },
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/comparison-table.js

@@ -0,0 +1,38 @@
+'use strict'
+
+module.exports = {
+  type:          'comparison-table',
+  name:          'Comparison Table',
+  description:   'Compare items across multiple dimensions.',
+  icon:          'table',
+  defaultWidth:  280,
+  defaultHeight: 150,
+  expansionMode: 'popup',
+  tags:          ['research', 'data'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          headers: element.data.headers || [],
+          rows:    element.data.rows    || [],
+        }
+      },
+      getPorts() {
+        return [
+          { key: 'items-in',  direction: 'input',  dataType: 'any',  label: 'Items In' },
+          { key: 'table-out', direction: 'output', dataType: 'json', label: 'Table Out' },
+        ]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/constraint.js

@@ -0,0 +1,32 @@
+'use strict'
+
+module.exports = {
+  type:          'constraint',
+  name:          'Constraint',
+  description:   'A hard or soft constraint on a solution.',
+  icon:          'lock',
+  defaultWidth:  180,
+  defaultHeight: 70,
+  expansionMode: 'inline',
+  tags:          ['thinking'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return { text: element.data.text || '', severity: element.data.severity || 'hard' }
+      },
+      getPorts() {
+        return [{ key: 'constraint-out', direction: 'output', dataType: 'text', label: 'Constraint Out' }]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/decision.js

@@ -0,0 +1,39 @@
+'use strict'
+
+module.exports = {
+  type:          'decision',
+  name:          'Decision',
+  description:   'Record a decision with rationale.',
+  icon:          'git-branch',
+  defaultWidth:  200,
+  defaultHeight: 90,
+  expansionMode: 'inline',
+  tags:          ['thinking'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          title:     element.data.title     || '',
+          chosen:    element.data.chosen    || '',
+          rationale: element.data.rationale || '',
+        }
+      },
+      getPorts() {
+        return [
+          { key: 'options-in',   direction: 'input',  dataType: 'any',  label: 'Options In' },
+          { key: 'decision-out', direction: 'output', dataType: 'text', label: 'Decision Out' },
+        ]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/diff-patch.js

@@ -0,0 +1,38 @@
+'use strict'
+
+module.exports = {
+  type:          'diff-patch',
+  name:          'Diff / Patch',
+  description:   'Show the diff between original and modified text.',
+  icon:          'git-diff',
+  defaultWidth:  280,
+  defaultHeight: 150,
+  expansionMode: 'popup',
+  tags:          ['dev'],
+  isBuiltIn:     true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          source: element.data.source || '',
+          change: element.data.change || '',
+        }
+      },
+      getPorts() {
+        return [
+          { key: 'source-in', direction: 'input',  dataType: 'text', label: 'Source In' },
+          { key: 'change-in', direction: 'input',  dataType: 'text', label: 'Change In' },
+          { key: 'change-out', direction: 'output', dataType: 'text', label: 'Change Out' },
+        ]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/divider.js

@@ -0,0 +1,30 @@
+'use strict'
+
+module.exports = {
+  type:          'divider',
+  name:          'Divider',
+  description:   'A visual separator line.',
+  icon:          'minus',
+  defaultWidth:  300,
+  defaultHeight: 4,
+  expansionMode: 'inline',
+  tags:          ['org'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return { color: element.data.color || '#475569', thickness: element.data.thickness || 1 }
+      },
+      getPorts() { return [] },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/document-draft.js

@@ -0,0 +1,35 @@
+'use strict'
+
+module.exports = {
+  type:          'document-draft',
+  name:          'Document Draft',
+  description:   'A document draft with title and content.',
+  icon:          'file-edit',
+  defaultWidth:  200,
+  defaultHeight: 100,
+  expansionMode: 'sidebar',
+  tags:          ['docs'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return { title: element.data.title || '', content: element.data.content || '' }
+      },
+      getPorts() {
+        return [
+          { key: 'sections-in', direction: 'input',  dataType: 'text', label: 'Sections In' },
+          { key: 'doc-out',     direction: 'output', dataType: 'text', label: 'Doc Out' },
+        ]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}