@geekbeer/minion 3.29.4 → 3.30.0

package/core/lib/dag-step-poller.js

@@ -126,6 +126,8 @@ async function executeSkillNode(node) {
     input_data,
     revision_feedback,
     review_history,
+    input_contracts,
+    output_contracts,
   } = node
 
   console.log(
@@ -174,16 +176,18 @@ async function executeSkillNode(node) {
       }
     }
 
-    // 4. Run the skill with input_data context
+    // 4. Run the skill with input_data and contract context
     const runPayload = {
       skill_name: skillName,
       execution_id,
       workflow_name: dag_workflow_name,
       role: assigned_role,
-      // DAG-specific: inject input_data as context
+      // DAG-specific: inject input_data and contracts as context
       dag_node_id: node_id,
       dag_input_data: input_data,
       dag_node_execution_id: node_execution_id,
+      dag_input_contracts: input_contracts || null,
+      dag_output_contracts: output_contracts || null,
     }
     if (revision_feedback) {
       runPayload.revision_feedback = revision_feedback
@@ -251,6 +255,7 @@ async function executeTransformNode(node) {
     assigned_role,
     input_data,
     transform_instruction,
+    output_contracts,
   } = node
 
   console.log(
@@ -285,7 +290,7 @@ async function executeTransformNode(node) {
 
     // 2. Create ephemeral skill from transform_instruction.
     // Write to every active plugin's skill dir so any Primary can find it.
-    const skillContent = buildTransformSkillContent(transform_instruction, input_data)
+    const skillContent = buildTransformSkillContent(transform_instruction, input_data, output_contracts)
     for (const dir of ephemeralSkillDirs) {
       await fs.mkdir(dir, { recursive: true })
       await fs.writeFile(path.join(dir, 'SKILL.md'), skillContent, 'utf-8')
@@ -353,8 +358,8 @@ async function executeTransformNode(node) {
 /**
  * Build SKILL.md content for a transform node's ephemeral skill.
  */
-function buildTransformSkillContent(instruction, inputData) {
-  return [
+function buildTransformSkillContent(instruction, inputData, outputContracts) {
+  const lines = [
     '---',
     'name: dag-transform',
     'description: DAG Transform Node',
@@ -369,12 +374,31 @@ function buildTransformSkillContent(instruction, inputData) {
     '',
     '## Transform Instruction',
     instruction,
+  ]
+
+  if (outputContracts && outputContracts.length > 0) {
+    lines.push('', '## Output Contract')
+    lines.push('Your output MUST conform to the following contract(s):')
+    for (const oc of outputContracts) {
+      lines.push(`### ${oc.contract_name}`)
+      lines.push(oc.contract.description || '')
+      lines.push('| Field | Type | Required | Description |')
+      lines.push('|-------|------|----------|-------------|')
+      for (const f of oc.contract.fields || []) {
+        lines.push(`| ${f.key} | ${f.type} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |`)
+      }
+    }
+  }
+
+  lines.push(
     '',
     '## Task',
     'Apply the transform instruction to the input data above.',
     'Output the result as a JSON object in an "## Output Data" section with a json code block.',
     'Do NOT output anything other than the Output Data section.',
-  ].join('\n')
+  )
+
+  return lines.join('\n')
 }
 
 /**

package/core/routes/skills.js

@@ -344,6 +344,9 @@ async function skillRoutes(fastify, opts) {
       revision_feedback,
       review_history,
       dag_node_execution_id,
+      dag_input_data,
+      dag_input_contracts,
+      dag_output_contracts,
     } = request.body || {}
 
     if (!skill_name) {
@@ -393,6 +396,9 @@ async function skillRoutes(fastify, opts) {
     if (role) runOptions.role = role
     if (revision_feedback) runOptions.revisionFeedback = revision_feedback
     if (review_history && review_history.length > 0) runOptions.reviewHistory = review_history
+    if (dag_input_data) runOptions.dagInputData = dag_input_data
+    if (dag_input_contracts) runOptions.dagInputContracts = dag_input_contracts
+    if (dag_output_contracts) runOptions.dagOutputContracts = dag_output_contracts
 
     // Run asynchronously — respond immediately
     const executionPromise = (async () => {

package/linux/workflow-runner.js

@@ -92,7 +92,38 @@ async function executeWorkflowSession(workflow, executionId, skillNames, options
     revisionContext = `## Revision Feedback\nThe reviewer requested changes to your previous output. Address the following feedback:\n${options.revisionFeedback}\n\n`
   }
 
-  const prompt = `${rolePrefix}${revisionContext}Run the following skills in order: ${skillCommands}.`
+  // Inject DAG input data context (data from upstream nodes)
+  let dagDataContext = ''
+  if (options.dagInputData && Object.keys(options.dagInputData).length > 0) {
+    dagDataContext = `## Input Data (from upstream nodes)\nThe following data was produced by upstream steps in this workflow. Use it as context for your task.\n\`\`\`json\n${JSON.stringify(options.dagInputData, null, 2)}\n\`\`\`\n\n`
+  }
+
+  // Inject DAG contract context (input/output contracts from edges)
+  let contractContext = ''
+  if (options.dagInputContracts && options.dagInputContracts.length > 0) {
+    contractContext += '## Input Contracts\nThe input data above conforms to the following contract(s):\n'
+    for (const ic of options.dagInputContracts) {
+      contractContext += `### ${ic.contract_name}\n${ic.contract.description || ''}\n`
+      contractContext += '| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n'
+      for (const f of ic.contract.fields || []) {
+        contractContext += `| ${f.key} | ${f.type} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |\n`
+      }
+    }
+    contractContext += '\n'
+  }
+  if (options.dagOutputContracts && options.dagOutputContracts.length > 0) {
+    contractContext += '## Output Contract\nYour output MUST conform to the following contract(s). Include all required fields in your execution report.\n'
+    for (const oc of options.dagOutputContracts) {
+      contractContext += `### ${oc.contract_name}\n${oc.contract.description || ''}\n`
+      contractContext += '| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n'
+      for (const f of oc.contract.fields || []) {
+        contractContext += `| ${f.key} | ${f.type} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |\n`
+      }
+    }
+    contractContext += '\n'
+  }
+
+  const prompt = `${rolePrefix}${revisionContext}${dagDataContext}${contractContext}Run the following skills in order: ${skillCommands}.`
 
   // Exit code file to capture CLI result
   const exitCodeFile = `/tmp/tmux-exit-${sessionName}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekbeer/minion",
-  "version": "3.29.4",
+  "version": "3.30.0",
   "description": "AI Agent runtime for Minion - manages status and skill deployment on VPS",
   "main": "linux/server.js",
   "bin": {

package/win/workflow-runner.js

@@ -99,7 +99,38 @@ async function executeWorkflowSession(workflow, executionId, skillNames, options
     revisionContext = `## Revision Feedback\nThe reviewer requested changes to your previous output. Address the following feedback:\n${options.revisionFeedback}\n\n`
   }
 
-  const prompt = `${rolePrefix}${revisionContext}Run the following skills in order: ${skillCommands}.`
+  // Inject DAG input data context (data from upstream nodes)
+  let dagDataContext = ''
+  if (options.dagInputData && Object.keys(options.dagInputData).length > 0) {
+    dagDataContext = `## Input Data (from upstream nodes)\nThe following data was produced by upstream steps in this workflow. Use it as context for your task.\n\`\`\`json\n${JSON.stringify(options.dagInputData, null, 2)}\n\`\`\`\n\n`
+  }
+
+  // Inject DAG contract context (input/output contracts from edges)
+  let contractContext = ''
+  if (options.dagInputContracts && options.dagInputContracts.length > 0) {
+    contractContext += '## Input Contracts\nThe input data above conforms to the following contract(s):\n'
+    for (const ic of options.dagInputContracts) {
+      contractContext += `### ${ic.contract_name}\n${ic.contract.description || ''}\n`
+      contractContext += '| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n'
+      for (const f of ic.contract.fields || []) {
+        contractContext += `| ${f.key} | ${f.type} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |\n`
+      }
+    }
+    contractContext += '\n'
+  }
+  if (options.dagOutputContracts && options.dagOutputContracts.length > 0) {
+    contractContext += '## Output Contract\nYour output MUST conform to the following contract(s). Include all required fields in your execution report.\n'
+    for (const oc of options.dagOutputContracts) {
+      contractContext += `### ${oc.contract_name}\n${oc.contract.description || ''}\n`
+      contractContext += '| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n'
+      for (const f of oc.contract.fields || []) {
+        contractContext += `| ${f.key} | ${f.type} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |\n`
+      }
+    }
+    contractContext += '\n'
+  }
+
+  const prompt = `${rolePrefix}${revisionContext}${dagDataContext}${contractContext}Run the following skills in order: ${skillCommands}.`
 
   const logFile = logManager.getLogPath(executionId)