@vention/vention-skills 0.9.9 → 0.9.10

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "vention",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines.",
   "author": {
     "name": "Vention"

package/README.md

@@ -1,6 +1,6 @@
 # Vention skills
 
-Version 0.9.9. Skills for coding agents that work with Vention machines, packaged as one plugin, `vention`, in the `vention-skills` marketplace.
+Version 0.9.10. Skills for coding agents that work with Vention machines, packaged as one plugin, `vention`, in the `vention-skills` marketplace.
 
 | Skill                       | What it does                                                                                                                         |
 | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vention/vention-skills",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines.",
   "license": "MIT",
   "type": "module",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "vention",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines.",
   "author": {
     "name": "Vention"

package/skills/vention-design/SKILL.md

@@ -3,7 +3,7 @@ name: vention-design
 description: Create, build and edit Vention machine designs and design graphs for agentic layout. Use when the user wants to start a new design, lay out an automation cell, add or reposition components in a Vention design, generate a machine layout from a description, add or place a floor plan image under a design, list a design's versions, or inspect an existing design graph. Trigger on MachineBuilder designs, design graphs, assembly graphs, extrusions, actuators, robot mounting, cell footprints, floor plans, or a machine-builder URL.
 license: MIT
 metadata:
-  version: "0.9.9"
+  version: "0.9.10"
   author: Vention
 ---
 

package/skills/vention-machine-logic/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: vention-machine-logic
-description: Write, edit, validate, and deploy MachineLogic Python applications for Vention machines with the machine-logic-sdk and the Vention CLI. Use when the user wants to program a Vention machine or MachineMotion controller, drive actuators, conveyors, robots, pneumatics, or digital I/O from Python, build a state machine for a cell, debug a failing application from its logs, or pull, push, or link an application with the Vention CLI (vention or vn). Trigger on MachineLogic, machine-logic-sdk, MachineMotion, MachineBuilder applications, or the Vention CLI, including inside a directory that holds .machine-code-app-directory-info.json. Do not use when the user has asked for no program at all and only wants an existing machine, its parts, or its configuration explained back to them in words; a read-only script that prints what the machine reports is still a program.
+description: Write, edit, validate, and deploy MachineLogic Python applications for Vention machines with the machine-logic-sdk and the Vention CLI. Load it before writing or changing any Python that talks to a Vention machine, however short, since device names and version-specific SDK calls come from here. Use to program a Vention machine or MachineMotion controller, drive actuators, conveyors, robots, pneumatics, or digital I/O, change an existing application, build a state machine, debug from logs, or pull, push, or link with the Vention CLI (vention or vn). Trigger on MachineLogic, machine-logic-sdk, MachineMotion, MachineBuilder applications, the Vention CLI, or a directory holding .machine-code-app-directory-info.json. Printing what the machine or robot holds now (positions, taught targets, calibration, I/O) is a program: files on disk hold only as-designed values. Not for explaining an existing machine or its configuration in words when no program is asked for, nor for Python that never touches the machine.
 license: MIT
 metadata:
-  version: "0.9.9"
+  version: "0.9.10"
   machine-logic-sdk: ">=3.0,<4"
   author: Vention
 ---
@@ -186,6 +186,18 @@ A blocking call with no `_async` version, such as `home`, goes through `asyncio.
 
 **State machines.** When the cell has modes (idle, running, paused, faulted) or reacts to events rather than running one sequence, use `vention-state-machine`: pin it in `requirements.txt`, read its README at that pin, and build on its `ready` and `fault` states. A machine has one active state, so concurrent machines are separate instances on the same loop. `examples/pick-and-place-state-machine` shows the shape; `examples/parallel-conveyor-with-recipe` shows parallel tasks with shared state and a recipe. If the README at that pin has no "State naming rules" section, give every member of a `StateGroup` a single word with no underscore: those versions split a nested state's name on `_`, so a member like `interlock_check` raises `KeyError: 'interlock'` when the machine is built.
 
+## MQTT
+
+Publish and subscribe through the SDK, which talks to the controller's broker; never add `paho-mqtt` or another client. The call depends on the pinned version:
+
+```python
+machine.mqtt.publish_event("cell/parts", str(count))  # 3.1.0 and later
+machine.mqtt.on_event("cell/commands", on_command)    # callback(topic, message), on an SDK thread
+
+machine.publish_mqtt_event("cell/parts", str(count))  # 3.0.x, where machine.mqtt does not exist
+machine.on_mqtt_event("cell/commands", on_command)
+```
+
 ## Taught robot positions
 
 `vention pull` also writes `.vention-design-scene-assets.json` when the design has taught positions. It is the list `machine.get_scene()` loads, one record per position or frame: its `type` names the getter that reads it (`RobotWaypoint` is `get_cartesian_target`, `RobotJointPosition` is `get_joint_target`, `RobotCalibrationFrame` is `get_calibration_frame`, `ReferenceFrame` is `get_reference_frame`) and `parameters.name` is the name to pass, character for character. Read it before naming a target. When a step needs a position the file does not hold, ask the user to teach it on the design; never map a missing step onto a target that happens to exist.

package/skills/vention-machine-logic-hmi/SKILL.md

@@ -3,7 +3,7 @@ name: vention-machine-logic-hmi
 description: Build or edit the custom operator HMI of a MachineLogic application, the React touch screen in customui/ that runs in MachineBuilder and on the MachineMotion pendant, wired to the application's Python process through vention-communication. Use when the user asks for an operator screen, a custom HMI or UI, a touch panel, start and stop buttons, live machine state on screen, or recipes an operator picks, for a Vention machine or inside a directory holding .machine-code-app-directory-info.json. Uses @vention/machine-ui, @vention/machine-apps-components and @vention/machine-logic-ui-sdk. Do not use for the no-code HMI Builder, or for the Python motion logic alone (that is vention-machine-logic).
 license: MIT
 metadata:
-  version: "0.9.9"
+  version: "0.9.10"
   author: Vention
 ---
 

package/skills/vention-monitoring/SKILL.md

@@ -3,7 +3,7 @@ name: vention-monitoring
 description: Diagnose deployed Vention machines from controller state, history, health, and activity data. Use when the user reports a machine that is down, faulted, offline, slow, or underperforming, asks why a cycle time regressed, wants to interpret MachineMotion event data or drive and brake status, asks about OEE or uptime, or wants to know which machine in a fleet needs attention. Trigger on a MachineMotion serial number plus any complaint.
 license: MIT
 metadata:
-  version: "0.9.9"
+  version: "0.9.10"
   author: Vention
 ---