Tool tree
Build, audition, and shape audio primitives through a focused visual signal chain.
Implementation
gradeNot graded
gradeNot graded
inspect-builderAnswer
Read the current Beat.Z builder and primitive parameters before creating, editing, or clearing. Does not change anything.
View tool JSON
{
"name": "inspect-builder",
"kind": "answer",
"impl": "imperative",
"description": "Read the current Beat.Z builder and primitive parameters before creating, editing, or clearing. Does not change anything.",
"inputSchema": {
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}
}create-pluginAction
Create a complete Beat.Z plugin from the user prompt. Requires a current inspect-builder context. Creates separate prompt-related Controls and stages one atomic design for visible approval.
View tool JSON
{
"name": "create-plugin",
"kind": "act",
"impl": "imperative",
"description": "Create a complete Beat.Z plugin from the user prompt. Requires a current inspect-builder context. Creates separate prompt-related Controls and stages one atomic design for visible approval.",
"inputSchema": {
"type": "object",
"properties": {
"contextId": {
"type": "string",
"minLength": 1,
"maxLength": 240,
"description": "Current contextId returned by inspect-builder."
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"description": "The user request being implemented."
},
"plugin": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"chain": {
"type": "array",
"minItems": 1,
"maxItems": 12,
"items": {
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Short reference used by Control mappings."
},
"primitive": {
"type": "string",
"enum": [
"gain",
"filter",
"saturation",
"delay",
"reverb",
"chorus",
"compressor",
"phaser",
"autowah",
"stutter",
"equalizer",
"limiter",
"flanger",
"tremolo"
]
},
"settings": {
"type": "object",
"description": "Primitive parameter values from inspect-builder.",
"additionalProperties": {
"oneOf": [
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 64
}
]
}
}
},
"required": [
"ref",
"primitive"
],
"additionalProperties": false
}
},
"controls": {
"type": "array",
"minItems": 1,
"maxItems": 8,
"items": {
"type": "object",
"properties": {
"controlId": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Existing Control ID when replacing a Control."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 24,
"description": "Visible Control label derived from the prompt."
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"description": "Optional short reason for this Control."
},
"value": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Optional initial Control position."
},
"mappings": {
"type": "array",
"minItems": 1,
"maxItems": 4,
"items": {
"type": "object",
"properties": {
"primitiveRef": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "A chain ref or inspected primitive ID."
},
"parameter": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "A mappable parameter ID from inspect-builder."
},
"min": {
"type": "number",
"description": "Value at the low end of the Control."
},
"max": {
"type": "number",
"description": "Value at the high end of the Control."
},
"inverted": {
"type": "boolean",
"description": "Reverse the Control direction when true."
}
},
"required": [
"primitiveRef",
"parameter",
"min",
"max"
],
"additionalProperties": false
}
}
},
"required": [
"name",
"mappings"
],
"additionalProperties": false
}
}
},
"required": [
"name",
"chain",
"controls"
],
"additionalProperties": false
}
},
"required": [
"contextId",
"prompt",
"plugin"
],
"additionalProperties": false
}
}edit-pluginAction
Edit the inspected Beat.Z plugin without replacing unrelated work. Requires current context, preserves existing state, and stages one atomic proposal for visible approval.
View tool JSON
{
"name": "edit-plugin",
"kind": "act",
"impl": "imperative",
"description": "Edit the inspected Beat.Z plugin without replacing unrelated work. Requires current context, preserves existing state, and stages one atomic proposal for visible approval.",
"inputSchema": {
"type": "object",
"properties": {
"contextId": {
"type": "string",
"minLength": 1,
"maxLength": 240,
"description": "Current contextId returned by inspect-builder."
},
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"description": "The requested edit in the user’s words."
},
"changes": {
"type": "array",
"minItems": 1,
"maxItems": 12,
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"action": {
"const": "rename-plugin"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"action",
"name"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"action": {
"const": "add-primitive"
},
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"primitive": {
"type": "string",
"enum": [
"gain",
"filter",
"saturation",
"delay",
"reverb",
"chorus",
"compressor",
"phaser",
"autowah",
"stutter",
"equalizer",
"limiter",
"flanger",
"tremolo"
]
},
"index": {
"type": "integer",
"minimum": 0
},
"settings": {
"type": "object",
"description": "Primitive parameter values from inspect-builder.",
"additionalProperties": {
"oneOf": [
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 64
}
]
}
}
},
"required": [
"action",
"ref",
"primitive"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"action": {
"const": "remove-primitive"
},
"primitiveId": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"action",
"primitiveId"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"action": {
"const": "move-primitive"
},
"primitiveId": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"index": {
"type": "integer",
"minimum": 0
}
},
"required": [
"action",
"primitiveId",
"index"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"action": {
"const": "set-parameter"
},
"primitiveId": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"parameter": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"value": {
"oneOf": [
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 64
}
]
}
},
"required": [
"action",
"primitiveId",
"parameter",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"action": {
"const": "set-bypass"
},
"primitiveId": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"bypassed": {
"type": "boolean"
}
},
"required": [
"action",
"primitiveId",
"bypassed"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"action": {
"const": "set-control"
},
"controlId": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Existing Control ID when replacing a Control."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 24,
"description": "Visible Control label derived from the prompt."
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"description": "Optional short reason for this Control."
},
"value": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Optional initial Control position."
},
"mappings": {
"type": "array",
"minItems": 1,
"maxItems": 4,
"items": {
"type": "object",
"properties": {
"primitiveRef": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "A chain ref or inspected primitive ID."
},
"parameter": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "A mappable parameter ID from inspect-builder."
},
"min": {
"type": "number",
"description": "Value at the low end of the Control."
},
"max": {
"type": "number",
"description": "Value at the high end of the Control."
},
"inverted": {
"type": "boolean",
"description": "Reverse the Control direction when true."
}
},
"required": [
"primitiveRef",
"parameter",
"min",
"max"
],
"additionalProperties": false
}
}
},
"required": [
"action",
"name",
"mappings"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"action": {
"const": "remove-control"
},
"controlId": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"action",
"controlId"
],
"additionalProperties": false
}
]
}
}
},
"required": [
"contextId",
"prompt",
"changes"
],
"additionalProperties": false
}
}clear-pluginAction
Stage removal of every primitive and Control from the current Beat.Z plugin. Nothing is erased until the user approves the proposal in the visible page.
View tool JSON
{
"name": "clear-plugin",
"kind": "act",
"impl": "imperative",
"description": "Stage removal of every primitive and Control from the current Beat.Z plugin. Nothing is erased until the user approves the proposal in the visible page.",
"inputSchema": {
"type": "object",
"properties": {
"contextId": {
"type": "string",
"minLength": 1,
"maxLength": 240,
"description": "Current contextId returned by inspect-builder."
}
},
"required": [
"contextId"
],
"additionalProperties": false
}
}