DH-Planner — viaSocket Plug Creation System
AI agents using the viaSocket MCP: start at skills/index.md — it picks the skill and points to the knowledge-base section index.
This repository contains the system prompt instructions used by the DH-Planner AI agent system on viaSocket to create and manage plug integrations.
What is viaSocket?
viaSocket is an AI workflow automation platform that connects 2000+ apps. A plug is a reusable integration that makes an app available as a step in automation workflows. Each plug defines:
- Triggers — Events from an app that start workflows
- Actions — Tasks an app performs (e.g., create a record, send a message)
Each action consists of:
- Input Fields (UI) — The form fields users interact with (dropdowns, text inputs, multiselects, etc.)
- Perform Code (Logic) — JavaScript code that executes the API call
Architecture
The system utilizes a multi-agent workflow to design, generate, and validate viaSocket integrations:
┌──────────────────────────────────────┐
│ DH-Master-Planner │ ← Orchestrator: routes, plans, & designs integration
└──────────────────┬───────────────────┘
│ delegates
▼
┌──────────────────────────────────────┐
│ Sub Agents │ ← Specialized task workers (complex & specialized tasks)
└──────────────────┬───────────────────┘
│ passes to
▼
┌──────────────────────────────────────┐
│ DH-Review │ ← Quality Gate: validates JSON schema & perform code
└──────────────────────────────────────┘
The orchestrator agent that:
- Routes requests based on the Phase 1 Master Switch (
actionVersionRowId + oldInputFields).
- Aligns with Knowledge Bases: References core rules in the Knowledge Base (such as ux-practice.md and dh-Input-fields-json-builder.md) before designing fields or outputting plans.
- Architects the UI (input fields) and API logic (perform code) using rules from perform-code.md.
- Delegates complex or specialized tasks to the appropriate sub-agents.
- Supports three operating modes: Initiate Create, Resume Create, and Surgical Update.
Specialized agents called by the Master Planner to handle specific parts of the integration building process:
| File | Role | Description |
|---|
| dh-plug-name-description.md | Action Metadata Generator | Generates clear, consistent action names, descriptions, types, and categories. |
| dh-reusable-component.md | Reusable Component Generator | Specializes in creating reusable components for dynamic dropdowns, multiselects, and dynamic fields. |
The final quality assurance reviewer agent that:
- Validates the generated input fields JSON and perform code.
- Checks compliance against the viaSocket Knowledge Bases.
- Outputs approval status, a structured list of issues/feedback, and a quality score.
Supported Field Types
The system supports the following input field types for plug actions:
| Type | Description |
|---|
| Dropdown | Static or dynamic select lists |
| Input Group | Grouped input fields |
| Multi-select | Multiple selection fields |
| Boolean | True/false toggles |
| Text Input | Free-text entry |
| HTML | Rich HTML content |
| Markdown | Markdown-formatted content |
| Dictionary | Key-value pair inputs |
| AI Field | AI-powered smart fields |
| Number | Numeric inputs |
| Date | Date/Time input fields |
| Help | Informational/helper text |
How It Works
- User provides a cURL command or describes an API action.
- Master Planner evaluates the request and routes it based on the action status.
- Input fields and Perform code are drafted based on API specifications.
- Sub-agents handle complex and specialized tasks (e.g., metadata generation, reusable components).
- DH-Review performs a final quality review of the input fields JSON and perform code.
- The approved configuration is used to create or update the plug action on viaSocket.
Resources
Additional Agents
