@newsails/veil-studio 1.0.0

package/server/utils/elements/fact-claim.js

@@ -0,0 +1,36 @@
+'use strict'
+
+module.exports = {
+  type:          'fact-claim',
+  name:          'Fact / Claim',
+  description:   'A verifiable fact or claim with confidence rating.',
+  icon:          'check-circle',
+  defaultWidth:  200,
+  defaultHeight: 80,
+  expansionMode: 'inline',
+  tags:          ['research', 'thinking'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          claim:      element.data.claim || '',
+          confidence: element.data.confidence ?? 0.5,
+          sourceIds:  element.data.sourceIds || [],
+        }
+      },
+      getPorts() {
+        return [{ key: 'claim-out', direction: 'output', dataType: 'text', label: 'Claim Out' }]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/feedback-request.js

@@ -0,0 +1,43 @@
+'use strict'
+
+module.exports = {
+  type:          'feedback-request',
+  name:          'Feedback Request',
+  description:   'Request feedback or input from an agent or user.',
+  icon:          'message-circle-question',
+  defaultWidth:  220,
+  defaultHeight: 90,
+  expansionMode: 'inline',
+  tags:          ['comm'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          question: element.data.question || '',
+          status:   element.data.status   || 'waiting',
+          response: element.data.response || null,
+        }
+      },
+      getPorts() {
+        return [
+          { key: 'question-in',  direction: 'input',  dataType: 'text', label: 'Question In' },
+          { key: 'response-out', direction: 'output', dataType: 'text', label: 'Response Out' },
+        ]
+      },
+      actions: {
+        respond({ response } = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, status: 'answered', response } })
+        },
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/file-reference.js

@@ -0,0 +1,31 @@
+'use strict'
+
+module.exports = {
+  type:          'file-reference',
+  name:          'File Reference',
+  description:   'Reference a file in the project directory.',
+  icon:          'file',
+  defaultWidth:  180,
+  defaultHeight: 70,
+  expansionMode: 'popup',
+  tags:          ['data', 'file'],
+  isBuiltIn:     true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return { filePath: element.data.filePath || null }
+      },
+      getPorts() {
+        return [{ key: 'file-out', direction: 'output', dataType: 'file', label: 'File Out' }]
+      },
+      actions: {
+        update({ filePath } = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, filePath } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/filter.js

@@ -0,0 +1,48 @@
+'use strict'
+
+module.exports = {
+  type:          'filter',
+  name:          'Filter',
+  description:   'Pass or reject input based on a JS expression.',
+  icon:          'filter',
+  defaultWidth:  200,
+  defaultHeight: 80,
+  expansionMode: 'inline',
+  tags:          ['flow'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element, log } = context
+    return {
+      getViewData() {
+        return { expression: element.data.expression || '' }
+      },
+      getPorts() {
+        return [
+          { key: 'input-in',     direction: 'input',  dataType: 'any', label: 'Input In' },
+          { key: 'out-passed',   direction: 'output', dataType: 'any', label: 'Passed' },
+          { key: 'out-rejected', direction: 'output', dataType: 'any', label: 'Rejected' },
+        ]
+      },
+      actions: {
+        evaluate({ input } = {}) {
+          const expr = element.data.expression
+          if (!expr) return { passed: true, rejected: false }
+          try {
+            // eslint-disable-next-line no-new-func
+            const result = new Function('input', `return (${expr})`)(input)
+            return { passed: !!result, rejected: !result }
+          } catch (err) {
+            log(`Filter expression error: ${err.message}`)
+            return { passed: false, rejected: true }
+          }
+        },
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/generator.js

@@ -0,0 +1,51 @@
+'use strict'
+
+module.exports = {
+  type:          'generator',
+  name:          'Generator',
+  description:   'Generate content by running an agent task with a prompt template.',
+  icon:          'cpu',
+  defaultWidth:  220,
+  defaultHeight: 130,
+  expansionMode: 'popup',
+  tags:          ['flow'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element, veil, log } = context
+    return {
+      getViewData() {
+        return {
+          agentName:      element.data.agentName      || null,
+          promptTemplate: element.data.promptTemplate || '',
+          inputType:      element.data.inputType      || 'text',
+          outputType:     element.data.outputType     || 'text',
+          spawnOutput:    element.data.spawnOutput    || false,
+        }
+      },
+      getPorts() {
+        return [
+          { key: 'input-in',  direction: 'input',  dataType: 'any',  label: 'Input In' },
+          { key: 'output-out', direction: 'output', dataType: 'any', label: 'Output Out' },
+        ]
+      },
+      actions: {
+        async run({ inputs } = {}) {
+          const agentName = element.data.agentName
+          if (!agentName) throw new Error('No agent name set')
+          const prompt = (element.data.promptTemplate || '').replace(/\{\{(\w+)\}\}/g, (_, k) => inputs?.[k] ?? `{{${k}}}`)
+          log(`Generating with agent "${agentName}"`)
+          const task = await veil.post('/tasks', { agent: agentName, prompt })
+          const { updateElement, updateElementState } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, lastTaskId: task.id } })
+          updateElementState(element.id, 'running')
+        },
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/goal.js

@@ -0,0 +1,36 @@
+'use strict'
+
+module.exports = {
+  type:          'goal',
+  name:          'Goal',
+  description:   'A goal with success criteria.',
+  icon:          'target',
+  defaultWidth:  200,
+  defaultHeight: 90,
+  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 || '',
+          criteria:    element.data.criteria    || [],
+        }
+      },
+      getPorts() {
+        return [{ key: 'goal-out', direction: 'output', dataType: 'text', label: 'Goal Out' }]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/html.js

@@ -0,0 +1,35 @@
+'use strict'
+
+module.exports = {
+  type:          'html',
+  name:          'HTML Preview',
+  description:   'Write HTML in edit mode, preview it live via a sandboxed iframe.',
+  icon:          'code-tags',
+  defaultWidth:  320,
+  defaultHeight: 240,
+  tags:          ['data', 'dev'],
+  isBuiltIn:     true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          html: element.data.html || '',
+        }
+      },
+      getPorts() {
+        return [
+          { key: 'html-in',  direction: 'input',  dataType: 'text', label: 'HTML In'  },
+          { key: 'html-out', direction: 'output', dataType: 'text', label: 'HTML Out' },
+        ]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/idea.js

@@ -0,0 +1,32 @@
+'use strict'
+
+module.exports = {
+  type:          'idea',
+  name:          'Idea',
+  description:   'Capture a single idea or insight.',
+  icon:          'lightbulb',
+  defaultWidth:  170,
+  defaultHeight: 80,
+  expansionMode: 'inline',
+  tags:          ['thinking'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return { text: element.data.text || '', category: element.data.category || null }
+      },
+      getPorts() {
+        return [{ key: 'idea-out', direction: 'output', dataType: 'text', label: 'Idea Out' }]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/image-local.js

@@ -0,0 +1,21 @@
+'use strict'
+
+module.exports = {
+  type:          'image-local',
+  name:          'Image (Local)',
+  description:   'Display a local file image by its path on disk.',
+  icon:          '🖼',
+  defaultWidth:  200,
+  defaultHeight: 160,
+  expansionMode: 'inline',
+  tags:          ['data', 'media'],
+  isBuiltIn:     true,
+
+  createInstance(_context) {
+    return {
+      getViewData() { return {} },
+      getPorts()    { return [] },
+      actions:      {},
+    }
+  },
+}

package/server/utils/elements/image.js

@@ -0,0 +1,34 @@
+'use strict'
+
+module.exports = {
+  type:          'image',
+  name:          'Image',
+  description:   'Display an image from the project directory.',
+  icon:          'image',
+  defaultWidth:  220,
+  defaultHeight: 160,
+  expansionMode: 'popup',
+  tags:          ['data', 'media'],
+  isBuiltIn:     true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return { filePath: element.data.filePath || null, alt: element.data.alt || '' }
+      },
+      getPorts() {
+        return [{ key: 'image-out', direction: 'output', dataType: 'file', label: 'Image Out' }]
+      },
+      actions: {
+        update({ filePath, alt } = {}) {
+          const { updateElement } = require('../board-state.js')
+          const data = { ...element.data }
+          if (filePath !== undefined) data.filePath = filePath
+          if (alt !== undefined)      data.alt      = alt
+          updateElement(element.id, { data })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/json-object.js

@@ -0,0 +1,47 @@
+'use strict'
+
+module.exports = {
+  type:          'json-object',
+  name:          'JSON Object',
+  description:   'Store and display a JSON object with dynamic output ports per top-level key.',
+  icon:          'braces',
+  defaultWidth:  220,
+  defaultHeight: 110,
+  expansionMode: 'popup',
+  tags:          ['data'],
+  isBuiltIn:     true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          content: element.data.content || {},
+          title:   element.data.title || '',
+        }
+      },
+      getPorts() {
+        const content = element.data.content || {}
+        const keyPorts = Object.keys(content).map(key => ({
+          key:       `out-${key}`,
+          direction: 'output',
+          dataType:  'any',
+          label:     key,
+        }))
+        return [
+          { key: 'full-out', direction: 'output', dataType: 'json', label: 'Full Object' },
+          ...keyPorts,
+        ]
+      },
+      actions: {
+        update({ content, title } = {}) {
+          const { updateElement } = require('../board-state.js')
+          const data = { ...element.data }
+          if (content !== undefined) data.content = content
+          if (title !== undefined)   data.title   = title
+          updateElement(element.id, { data })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/label-tag.js

@@ -0,0 +1,30 @@
+'use strict'
+
+module.exports = {
+  type:          'label-tag',
+  name:          'Label / Tag',
+  description:   'A visual label or tag for organizing elements.',
+  icon:          'tag',
+  defaultWidth:  120,
+  defaultHeight: 36,
+  expansionMode: 'inline',
+  tags:          ['org'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return { text: element.data.text || '', color: element.data.color || '#3b82f6' }
+      },
+      getPorts() { return [] },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/markdown.js

@@ -0,0 +1,37 @@
+'use strict'
+
+module.exports = {
+  type:          'markdown',
+  name:          'Markdown',
+  description:   'A markdown note with rendered preview and edit/read toggle.',
+  icon:          'file-text',
+  defaultWidth:  220,
+  defaultHeight: 140,
+  expansionMode: 'inline',
+  tags:          ['data', 'content'],
+  isBuiltIn:     true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          content: element.data.content || '',
+          title:   element.data.title   || '',
+        }
+      },
+      getPorts() {
+        return [{ key: 'text-out', direction: 'output', dataType: 'text', label: 'Text Out' }]
+      },
+      actions: {
+        update({ content, title } = {}) {
+          const { updateElement } = require('../board-state.js')
+          const data = { ...element.data }
+          if (content !== undefined) data.content = content
+          if (title   !== undefined) data.title   = title
+          updateElement(element.id, { data })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/merger.js

@@ -0,0 +1,36 @@
+'use strict'
+
+module.exports = {
+  type:          'merger',
+  name:          'Merger',
+  description:   'Combine multiple inputs into a single output.',
+  icon:          'merge',
+  defaultWidth:  200,
+  defaultHeight: 90,
+  expansionMode: 'inline',
+  tags:          ['flow'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return { strategy: element.data.strategy || 'concat' }
+      },
+      getPorts() {
+        return [
+          { key: 'in-a',      direction: 'input',  dataType: 'any',  label: 'Input A' },
+          { key: 'in-b',      direction: 'input',  dataType: 'any',  label: 'Input B' },
+          { key: 'merged-out', direction: 'output', dataType: 'any',  label: 'Merged Out' },
+        ]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/message.js

@@ -0,0 +1,40 @@
+'use strict'
+
+module.exports = {
+  type:          'message',
+  name:          'Message',
+  description:   'A single message with sender and content.',
+  icon:          'message-square',
+  defaultWidth:  200,
+  defaultHeight: 80,
+  expansionMode: 'inline',
+  tags:          ['comm'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          from:      element.data.from      || '',
+          content:   element.data.content   || '',
+          timestamp: element.data.timestamp || null,
+          to:        element.data.to        || null,
+        }
+      },
+      getPorts() {
+        return [
+          { key: 'msg-in',  direction: 'input',  dataType: 'text', label: 'Message In' },
+          { key: 'msg-out', direction: 'output', dataType: 'text', label: 'Message Out' },
+        ]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/milestone.js

@@ -0,0 +1,44 @@
+'use strict'
+
+module.exports = {
+  type:          'milestone',
+  name:          'Milestone',
+  description:   'A project milestone with deadline.',
+  icon:          'flag',
+  defaultWidth:  220,
+  defaultHeight: 90,
+  expansionMode: 'inline',
+  tags:          ['pm'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          title:     element.data.title     || '',
+          deadline:  element.data.deadline  || null,
+          completed: element.data.completed || false,
+          taskIds:   element.data.taskIds   || [],
+        }
+      },
+      getPorts() {
+        return [
+          { key: 'tasks-in',   direction: 'input',  dataType: 'any',  label: 'Tasks In' },
+          { key: 'status-out', direction: 'output', dataType: 'text', label: 'Status Out' },
+        ]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+        complete(_params) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, completed: true } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/notification.js

@@ -0,0 +1,34 @@
+'use strict'
+
+module.exports = {
+  type:          'notification',
+  name:          'Notification',
+  description:   'A styled notification card with color, icon, title, and content.',
+  icon:          'bell',
+  defaultWidth:  220,
+  defaultHeight: 100,
+  expansionMode: 'inline',
+  tags:          ['data'],
+  isBuiltIn:     true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return {
+          color:   element.data.color   || '#60a5fa',
+          icon:    element.data.icon    || '',
+          title:   element.data.title   || '',
+          content: element.data.content || '',
+        }
+      },
+      getPorts() { return [] },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}

package/server/utils/elements/outline.js

@@ -0,0 +1,35 @@
+'use strict'
+
+module.exports = {
+  type:          'outline',
+  name:          'Outline',
+  description:   'A hierarchical outline with nested nodes.',
+  icon:          'list-tree',
+  defaultWidth:  220,
+  defaultHeight: 140,
+  expansionMode: 'popup',
+  tags:          ['docs'],
+  isBuiltIn:         true,
+  hiddenFromPalette: true,
+
+  createInstance(context) {
+    const { element } = context
+    return {
+      getViewData() {
+        return { title: element.data.title || '', nodes: element.data.nodes || [] }
+      },
+      getPorts() {
+        return [
+          { key: 'items-in',     direction: 'input',  dataType: 'any',  label: 'Items In' },
+          { key: 'structure-out', direction: 'output', dataType: 'json', label: 'Structure Out' },
+        ]
+      },
+      actions: {
+        update(data = {}) {
+          const { updateElement } = require('../board-state.js')
+          updateElement(element.id, { data: { ...element.data, ...data } })
+        },
+      },
+    }
+  },
+}