Provider reference#
Every provider Pocket installs, with its Python signature, command-line form and MCP input schema. This page is generated from package 0.5.0.dev0 at source revision 8729e28807f2, so it always matches the code.
Only inputs are described: receipts are open JSON dictionaries whose fields depend on the call. Call capabilities_list to see current profiles and prerequisites on your own installation. The local workspace and practice review pages have their own browser routes; there is no general HTTP API. New to the vocabulary? Start with key ideas.
Download complete contracts · Download all MCP tools
83 providers, and 143 MCP registrations in total, including tool-family and compatibility names.
shuttle_build_bridge Build the optional local Serato/FLX4 bridge without starting it.
Domain: performance. Read only: false.
Python
pocket_music.shuttle.shuttle_build_bridge(output_dir: 'str') -> 'dict'CLI
pocket shuttle-build-bridge --spec <arguments.json>MCP input schema
{
"properties": {
"output_dir": {
"title": "Output Dir",
"type": "string"
}
},
"required": [
"output_dir"
],
"title": "shuttle_build_bridgeArguments",
"type": "object",
"additionalProperties": false
}shuttle_prepare Snapshot one local crate and prepare an unordered Whisker session.
Domain: performance. Read only: false.
Python
pocket_music.shuttle.shuttle_prepare(crate_name: 'str', output_dir: 'str', runtime_dir: 'str', library_path: 'str | None' = None, intent: 'dict | None' = None) -> 'dict'CLI
pocket shuttle-prepare --spec <arguments.json>MCP input schema
{
"properties": {
"crate_name": {
"title": "Crate Name",
"type": "string"
},
"output_dir": {
"title": "Output Dir",
"type": "string"
},
"runtime_dir": {
"title": "Runtime Dir",
"type": "string"
},
"library_path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Library Path"
},
"intent": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Intent"
}
},
"required": [
"crate_name",
"output_dir",
"runtime_dir"
],
"title": "shuttle_prepareArguments",
"type": "object",
"additionalProperties": false
}shuttle_observe Read fresh supported Serato state and actual master signal; no listening claim.
Domain: performance. Read only: true.
Python
pocket_music.shuttle.shuttle_observe(session_dir: 'str') -> 'dict'CLI
pocket shuttle-observe --spec <arguments.json>MCP input schema
{
"properties": {
"session_dir": {
"title": "Session Dir",
"type": "string"
}
},
"required": [
"session_dir"
],
"title": "shuttle_observeArguments",
"type": "object",
"additionalProperties": false
}shuttle_options Propose next records using the crate, history and observed current deck.
Domain: performance. Read only: true.
Python
pocket_music.shuttle.shuttle_options(session_dir: 'str', limit: 'int' = 6, intent: 'dict | None' = None) -> 'dict'CLI
pocket shuttle-options --spec <arguments.json>MCP input schema
{
"properties": {
"session_dir": {
"title": "Session Dir",
"type": "string"
},
"limit": {
"default": 6,
"title": "Limit",
"type": "integer"
},
"intent": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Intent"
}
},
"required": [
"session_dir"
],
"title": "shuttle_optionsArguments",
"type": "object",
"additionalProperties": false
}shuttle_act One revision-checked bounded move with native observation, replay and FLX4 takeover.
Domain: performance. Read only: false.
Python
pocket_music.shuttle.shuttle_act(session_dir: 'str', expected_revision: 'int', request_id: 'str', action: 'ShuttleAction') -> 'dict'CLI
pocket shuttle-act --spec <arguments.json>MCP input schema
{
"$defs": {
"ShuttleAction": {
"properties": {
"kind": {
"enum": [
"claim",
"release",
"load",
"play",
"pause",
"gain",
"loop",
"sync"
],
"title": "Kind",
"type": "string"
},
"deck": {
"enum": [
"left",
"right"
],
"title": "Deck",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"value": {
"title": "Value",
"type": "integer"
},
"duration_seconds": {
"title": "Duration Seconds",
"type": "number"
},
"beats": {
"anyOf": [
{
"enum": [
8,
16
],
"type": "integer"
},
{
"type": "null"
}
],
"title": "Beats"
},
"allow_silence": {
"title": "Allow Silence",
"type": "boolean"
}
},
"required": [
"kind"
],
"title": "ShuttleAction",
"type": "object"
}
},
"properties": {
"session_dir": {
"title": "Session Dir",
"type": "string"
},
"expected_revision": {
"title": "Expected Revision",
"type": "integer"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"action": {
"$ref": "#/$defs/ShuttleAction"
}
},
"required": [
"session_dir",
"expected_revision",
"request_id",
"action"
],
"title": "shuttle_actArguments",
"type": "object",
"additionalProperties": false
}shuttle_request_status Inspect a retained native request without redispatch.
Domain: performance. Read only: true.
Python
pocket_music.shuttle.shuttle_request_status(session_dir: 'str', request_id: 'str') -> 'dict'CLI
pocket shuttle-request-status --spec <arguments.json>MCP input schema
{
"properties": {
"session_dir": {
"title": "Session Dir",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"session_dir",
"request_id"
],
"title": "shuttle_request_statusArguments",
"type": "object",
"additionalProperties": false
}request_status Inspect request journals and retained artifact integrity without redispatching.
Domain: artifact. Read only: true.
Python
pocket_music.artifact_store.request_status(store_root: 'str', request_id: 'str') -> 'dict'CLI
pocket request-status --spec <arguments.json>MCP input schema
{
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"store_root",
"request_id"
],
"title": "request_statusArguments",
"type": "object",
"additionalProperties": false
}material_import Retain source bytes and project supported MIDI material.
Domain: material. Read only: false.
Python
pocket_music.material.material_import(source: 'MaterialSource', store_root: 'str', request_id: 'str') -> 'dict'CLI
pocket material-import --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ClipRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"$ref": "#/$defs/Rational"
},
"loop": {
"const": false,
"title": "Loop",
"type": "boolean"
},
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"event_ids": {
"items": {
"type": "string"
},
"title": "Event Ids",
"type": "array"
},
"curve_ids": {
"items": {
"type": "string"
},
"title": "Curve Ids",
"type": "array"
}
},
"required": [
"id",
"track_id",
"origin",
"length_qn",
"loop",
"note_ids",
"event_ids",
"curve_ids"
],
"title": "ClipRecord",
"type": "object"
},
"MaterialRecord": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.material/v1",
"title": "Schema",
"type": "string"
},
"material_id": {
"title": "Material Id",
"type": "string"
},
"revision_sha256": {
"title": "Revision Sha256",
"type": "string"
},
"parent_revision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Revision"
},
"sources": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Sources",
"type": "array"
},
"tracks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Tracks",
"type": "array"
},
"clips": {
"items": {
"$ref": "#/$defs/ClipRecord"
},
"title": "Clips",
"type": "array"
},
"notes": {
"items": {
"$ref": "#/$defs/NoteRecord"
},
"title": "Notes",
"type": "array"
},
"events": {
"items": {
"$ref": "#/$defs/WireEvent"
},
"title": "Events",
"type": "array"
},
"curves": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Curves",
"type": "array"
},
"tempo_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"meter_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"coverage": {
"additionalProperties": true,
"title": "Coverage",
"type": "object"
},
"provenance": {
"additionalProperties": true,
"title": "Provenance",
"type": "object"
}
},
"required": [
"schema",
"material_id",
"revision_sha256",
"parent_revision",
"sources",
"tracks",
"clips",
"notes",
"events",
"curves",
"tempo_map_ref",
"meter_map_ref",
"coverage",
"provenance"
],
"title": "MaterialRecord",
"type": "object"
},
"MaterialSource": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"smf",
"live_clip",
"material"
],
"title": "Kind",
"type": "string"
},
"path": {
"title": "Path",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"thread_handle": {
"additionalProperties": true,
"title": "Thread Handle",
"type": "object"
},
"clip_id": {
"title": "Clip Id",
"type": "string"
},
"material": {
"$ref": "#/$defs/MaterialRecord"
}
},
"required": [
"kind"
],
"title": "MaterialSource",
"type": "object"
},
"NoteRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"voice_id": {
"title": "Voice Id",
"type": "string"
},
"role_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Role Ref"
},
"onset": {
"$ref": "#/$defs/Position"
},
"duration_qn": {
"$ref": "#/$defs/Rational"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
},
"velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"release_velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"mute": {
"title": "Mute",
"type": "boolean"
},
"expression_refs": {
"items": {
"type": "string"
},
"title": "Expression Refs",
"type": "array"
},
"source_binding": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Source Binding"
},
"derived_from": {
"items": {
"type": "string"
},
"title": "Derived From",
"type": "array"
}
},
"required": [
"id",
"voice_id",
"role_ref",
"onset",
"duration_qn",
"pitch",
"velocity",
"release_velocity",
"channel",
"mute",
"expression_refs",
"source_binding",
"derived_from"
],
"title": "NoteRecord",
"type": "object"
},
"PitchRecord": {
"additionalProperties": false,
"properties": {
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
}
],
"title": "Cents Offset"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"midi_note",
"cents_offset",
"tuning_ref"
],
"title": "PitchRecord",
"type": "object"
},
"Position": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
},
"space": {
"enum": [
"clip_qn",
"phrase_qn",
"arrangement_qn"
],
"title": "Space",
"type": "string"
}
},
"required": [
"n",
"d",
"space"
],
"title": "Position",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"VelocityRecord": {
"additionalProperties": false,
"properties": {
"value": {
"title": "Value",
"type": "integer"
},
"domain": {
"const": "midi1_7bit",
"title": "Domain",
"type": "string"
}
},
"required": [
"value",
"domain"
],
"title": "VelocityRecord",
"type": "object"
},
"WireEvent": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"time": {
"$ref": "#/$defs/Position"
},
"order": {
"title": "Order",
"type": "integer"
},
"message_type": {
"title": "Message Type",
"type": "string"
},
"is_meta": {
"title": "Is Meta",
"type": "boolean"
},
"bytes": {
"items": {
"type": "integer"
},
"title": "Bytes",
"type": "array"
},
"source_tick": {
"title": "Source Tick",
"type": "integer"
},
"track_index": {
"title": "Track Index",
"type": "integer"
}
},
"required": [
"id",
"time",
"order",
"message_type",
"is_meta",
"bytes"
],
"title": "WireEvent",
"type": "object"
}
},
"properties": {
"source": {
"$ref": "#/$defs/MaterialSource"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"source",
"store_root",
"request_id"
],
"title": "material_importArguments",
"type": "object",
"additionalProperties": false
}material_query Bounded summaries, exact selections and semantic differences.
Domain: material. Read only: true.
Python
pocket_music.material.material_query(material: 'ArtifactHandle | MaterialRecord', store_root: 'str', query: 'str' = 'summary', selection: 'MaterialSelection | None' = None, limit: 'int' = 64, cursor: 'str | None' = None, max_bytes: 'int' = 16000, comparison: 'ArtifactHandle | MaterialRecord | None' = None) -> 'dict'CLI
pocket material-query --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ClipRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"$ref": "#/$defs/Rational"
},
"loop": {
"const": false,
"title": "Loop",
"type": "boolean"
},
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"event_ids": {
"items": {
"type": "string"
},
"title": "Event Ids",
"type": "array"
},
"curve_ids": {
"items": {
"type": "string"
},
"title": "Curve Ids",
"type": "array"
}
},
"required": [
"id",
"track_id",
"origin",
"length_qn",
"loop",
"note_ids",
"event_ids",
"curve_ids"
],
"title": "ClipRecord",
"type": "object"
},
"MaterialRecord": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.material/v1",
"title": "Schema",
"type": "string"
},
"material_id": {
"title": "Material Id",
"type": "string"
},
"revision_sha256": {
"title": "Revision Sha256",
"type": "string"
},
"parent_revision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Revision"
},
"sources": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Sources",
"type": "array"
},
"tracks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Tracks",
"type": "array"
},
"clips": {
"items": {
"$ref": "#/$defs/ClipRecord"
},
"title": "Clips",
"type": "array"
},
"notes": {
"items": {
"$ref": "#/$defs/NoteRecord"
},
"title": "Notes",
"type": "array"
},
"events": {
"items": {
"$ref": "#/$defs/WireEvent"
},
"title": "Events",
"type": "array"
},
"curves": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Curves",
"type": "array"
},
"tempo_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"meter_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"coverage": {
"additionalProperties": true,
"title": "Coverage",
"type": "object"
},
"provenance": {
"additionalProperties": true,
"title": "Provenance",
"type": "object"
}
},
"required": [
"schema",
"material_id",
"revision_sha256",
"parent_revision",
"sources",
"tracks",
"clips",
"notes",
"events",
"curves",
"tempo_map_ref",
"meter_map_ref",
"coverage",
"provenance"
],
"title": "MaterialRecord",
"type": "object"
},
"MaterialSelection": {
"additionalProperties": false,
"properties": {
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"voice_ids": {
"items": {
"type": "string"
},
"title": "Voice Ids",
"type": "array"
},
"clip_ids": {
"items": {
"type": "string"
},
"title": "Clip Ids",
"type": "array"
},
"span_qn": {
"items": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
]
},
"title": "Span Qn",
"type": "array"
},
"time_space": {
"const": "clip_qn",
"title": "Time Space",
"type": "string"
},
"material_revision": {
"title": "Material Revision",
"type": "string"
},
"selection_sha256": {
"title": "Selection Sha256",
"type": "string"
}
},
"title": "MaterialSelection",
"type": "object"
},
"NoteRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"voice_id": {
"title": "Voice Id",
"type": "string"
},
"role_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Role Ref"
},
"onset": {
"$ref": "#/$defs/Position"
},
"duration_qn": {
"$ref": "#/$defs/Rational"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
},
"velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"release_velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"mute": {
"title": "Mute",
"type": "boolean"
},
"expression_refs": {
"items": {
"type": "string"
},
"title": "Expression Refs",
"type": "array"
},
"source_binding": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Source Binding"
},
"derived_from": {
"items": {
"type": "string"
},
"title": "Derived From",
"type": "array"
}
},
"required": [
"id",
"voice_id",
"role_ref",
"onset",
"duration_qn",
"pitch",
"velocity",
"release_velocity",
"channel",
"mute",
"expression_refs",
"source_binding",
"derived_from"
],
"title": "NoteRecord",
"type": "object"
},
"PitchRecord": {
"additionalProperties": false,
"properties": {
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
}
],
"title": "Cents Offset"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"midi_note",
"cents_offset",
"tuning_ref"
],
"title": "PitchRecord",
"type": "object"
},
"Position": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
},
"space": {
"enum": [
"clip_qn",
"phrase_qn",
"arrangement_qn"
],
"title": "Space",
"type": "string"
}
},
"required": [
"n",
"d",
"space"
],
"title": "Position",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"VelocityRecord": {
"additionalProperties": false,
"properties": {
"value": {
"title": "Value",
"type": "integer"
},
"domain": {
"const": "midi1_7bit",
"title": "Domain",
"type": "string"
}
},
"required": [
"value",
"domain"
],
"title": "VelocityRecord",
"type": "object"
},
"WireEvent": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"time": {
"$ref": "#/$defs/Position"
},
"order": {
"title": "Order",
"type": "integer"
},
"message_type": {
"title": "Message Type",
"type": "string"
},
"is_meta": {
"title": "Is Meta",
"type": "boolean"
},
"bytes": {
"items": {
"type": "integer"
},
"title": "Bytes",
"type": "array"
},
"source_tick": {
"title": "Source Tick",
"type": "integer"
},
"track_index": {
"title": "Track Index",
"type": "integer"
}
},
"required": [
"id",
"time",
"order",
"message_type",
"is_meta",
"bytes"
],
"title": "WireEvent",
"type": "object"
}
},
"properties": {
"material": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/MaterialRecord"
}
],
"title": "Material"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"query": {
"default": "summary",
"title": "Query",
"type": "string"
},
"selection": {
"anyOf": [
{
"$ref": "#/$defs/MaterialSelection"
},
{
"type": "null"
}
],
"default": null
},
"limit": {
"default": 64,
"title": "Limit",
"type": "integer"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cursor"
},
"max_bytes": {
"default": 16000,
"title": "Max Bytes",
"type": "integer"
},
"comparison": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/MaterialRecord"
},
{
"type": "null"
}
],
"default": null,
"title": "Comparison"
}
},
"required": [
"material",
"store_root"
],
"title": "material_queryArguments",
"type": "object",
"additionalProperties": false
}material_sequence Construct declared whole-clip note occurrences with retained parents and explicit clock/placement.
Domain: material. Read only: false.
Python
pocket_music.material_sequence.material_sequence(*, store_root: 'str', request_id: 'str', definition: 'SequenceDefinition') -> 'dict'CLI
pocket material-sequence --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ClipRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"$ref": "#/$defs/Rational"
},
"loop": {
"const": false,
"title": "Loop",
"type": "boolean"
},
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"event_ids": {
"items": {
"type": "string"
},
"title": "Event Ids",
"type": "array"
},
"curve_ids": {
"items": {
"type": "string"
},
"title": "Curve Ids",
"type": "array"
}
},
"required": [
"id",
"track_id",
"origin",
"length_qn",
"loop",
"note_ids",
"event_ids",
"curve_ids"
],
"title": "ClipRecord",
"type": "object"
},
"MaterialRecord": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.material/v1",
"title": "Schema",
"type": "string"
},
"material_id": {
"title": "Material Id",
"type": "string"
},
"revision_sha256": {
"title": "Revision Sha256",
"type": "string"
},
"parent_revision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Revision"
},
"sources": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Sources",
"type": "array"
},
"tracks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Tracks",
"type": "array"
},
"clips": {
"items": {
"$ref": "#/$defs/ClipRecord"
},
"title": "Clips",
"type": "array"
},
"notes": {
"items": {
"$ref": "#/$defs/NoteRecord"
},
"title": "Notes",
"type": "array"
},
"events": {
"items": {
"$ref": "#/$defs/WireEvent"
},
"title": "Events",
"type": "array"
},
"curves": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Curves",
"type": "array"
},
"tempo_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"meter_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"coverage": {
"additionalProperties": true,
"title": "Coverage",
"type": "object"
},
"provenance": {
"additionalProperties": true,
"title": "Provenance",
"type": "object"
}
},
"required": [
"schema",
"material_id",
"revision_sha256",
"parent_revision",
"sources",
"tracks",
"clips",
"notes",
"events",
"curves",
"tempo_map_ref",
"meter_map_ref",
"coverage",
"provenance"
],
"title": "MaterialRecord",
"type": "object"
},
"NoteRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"voice_id": {
"title": "Voice Id",
"type": "string"
},
"role_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Role Ref"
},
"onset": {
"$ref": "#/$defs/Position"
},
"duration_qn": {
"$ref": "#/$defs/Rational"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
},
"velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"release_velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"mute": {
"title": "Mute",
"type": "boolean"
},
"expression_refs": {
"items": {
"type": "string"
},
"title": "Expression Refs",
"type": "array"
},
"source_binding": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Source Binding"
},
"derived_from": {
"items": {
"type": "string"
},
"title": "Derived From",
"type": "array"
}
},
"required": [
"id",
"voice_id",
"role_ref",
"onset",
"duration_qn",
"pitch",
"velocity",
"release_velocity",
"channel",
"mute",
"expression_refs",
"source_binding",
"derived_from"
],
"title": "NoteRecord",
"type": "object"
},
"PitchRecord": {
"additionalProperties": false,
"properties": {
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
}
],
"title": "Cents Offset"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"midi_note",
"cents_offset",
"tuning_ref"
],
"title": "PitchRecord",
"type": "object"
},
"Position": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
},
"space": {
"enum": [
"clip_qn",
"phrase_qn",
"arrangement_qn"
],
"title": "Space",
"type": "string"
}
},
"required": [
"n",
"d",
"space"
],
"title": "Position",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"SequenceDefinition": {
"additionalProperties": false,
"properties": {
"label": {
"title": "Label",
"type": "string"
},
"materials": {
"items": {
"$ref": "#/$defs/SequenceMaterial"
},
"title": "Materials",
"type": "array"
},
"clock": {
"$ref": "#/$defs/TimeContext"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Length Qn"
},
"occurrences": {
"items": {
"$ref": "#/$defs/SequenceOccurrence"
},
"title": "Occurrences",
"type": "array"
},
"controller_policy": {
"const": "reject_present",
"title": "Controller Policy",
"type": "string"
},
"expression_policy": {
"const": "reject_present",
"title": "Expression Policy",
"type": "string"
},
"overlap_policy": {
"const": "reject_same_channel_pitch",
"title": "Overlap Policy",
"type": "string"
}
},
"required": [
"label",
"materials",
"clock",
"origin",
"length_qn",
"occurrences",
"controller_policy",
"expression_policy",
"overlap_policy"
],
"title": "SequenceDefinition",
"type": "object"
},
"SequenceMaterial": {
"additionalProperties": false,
"properties": {
"key": {
"title": "Key",
"type": "string"
},
"material": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/MaterialRecord"
}
],
"title": "Material"
}
},
"required": [
"key",
"material"
],
"title": "SequenceMaterial",
"type": "object"
},
"SequenceOccurrence": {
"additionalProperties": false,
"properties": {
"occurrence_id": {
"title": "Occurrence Id",
"type": "string"
},
"material_key": {
"title": "Material Key",
"type": "string"
},
"material_revision": {
"title": "Material Revision",
"type": "string"
},
"clip_id": {
"title": "Clip Id",
"type": "string"
},
"at_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "At Qn"
}
},
"required": [
"occurrence_id",
"material_key",
"material_revision",
"clip_id",
"at_qn"
],
"title": "SequenceOccurrence",
"type": "object"
},
"TimeContext": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.time-context/v1",
"title": "Schema",
"type": "string"
},
"context_id": {
"title": "Context Id",
"type": "string"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"source": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"schema",
"context_id",
"attribution"
],
"title": "TimeContext",
"type": "object"
},
"VelocityRecord": {
"additionalProperties": false,
"properties": {
"value": {
"title": "Value",
"type": "integer"
},
"domain": {
"const": "midi1_7bit",
"title": "Domain",
"type": "string"
}
},
"required": [
"value",
"domain"
],
"title": "VelocityRecord",
"type": "object"
},
"WireEvent": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"time": {
"$ref": "#/$defs/Position"
},
"order": {
"title": "Order",
"type": "integer"
},
"message_type": {
"title": "Message Type",
"type": "string"
},
"is_meta": {
"title": "Is Meta",
"type": "boolean"
},
"bytes": {
"items": {
"type": "integer"
},
"title": "Bytes",
"type": "array"
},
"source_tick": {
"title": "Source Tick",
"type": "integer"
},
"track_index": {
"title": "Track Index",
"type": "integer"
}
},
"required": [
"id",
"time",
"order",
"message_type",
"is_meta",
"bytes"
],
"title": "WireEvent",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"definition": {
"$ref": "#/$defs/SequenceDefinition"
}
},
"required": [
"store_root",
"request_id",
"definition"
],
"title": "material_sequenceArguments",
"type": "object",
"additionalProperties": false
}material_structure Attributed phrase and motif relationships bound to exact material revisions.
Domain: material. Read only: false.
Python
pocket_music.material_structure.material_structure(operation: "Literal['create', 'query']", store_root: 'str', request_id: 'str | None' = None, definition: 'StructureDefinition | None' = None, structure: 'ArtifactHandle | None' = None, section: "Literal['summary', 'nodes', 'relations', 'members']" = 'summary', node_ids: 'list[str] | None' = None, limit: 'int' = 64, cursor: 'str | None' = None, max_bytes: 'int' = 16000) -> 'dict'CLI
pocket material-structure --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ClipRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"$ref": "#/$defs/Rational"
},
"loop": {
"const": false,
"title": "Loop",
"type": "boolean"
},
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"event_ids": {
"items": {
"type": "string"
},
"title": "Event Ids",
"type": "array"
},
"curve_ids": {
"items": {
"type": "string"
},
"title": "Curve Ids",
"type": "array"
}
},
"required": [
"id",
"track_id",
"origin",
"length_qn",
"loop",
"note_ids",
"event_ids",
"curve_ids"
],
"title": "ClipRecord",
"type": "object"
},
"MaterialBinding": {
"additionalProperties": false,
"properties": {
"key": {
"title": "Key",
"type": "string"
},
"material": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/MaterialRecord"
}
],
"title": "Material"
}
},
"required": [
"key",
"material"
],
"title": "MaterialBinding",
"type": "object"
},
"MaterialRecord": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.material/v1",
"title": "Schema",
"type": "string"
},
"material_id": {
"title": "Material Id",
"type": "string"
},
"revision_sha256": {
"title": "Revision Sha256",
"type": "string"
},
"parent_revision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Revision"
},
"sources": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Sources",
"type": "array"
},
"tracks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Tracks",
"type": "array"
},
"clips": {
"items": {
"$ref": "#/$defs/ClipRecord"
},
"title": "Clips",
"type": "array"
},
"notes": {
"items": {
"$ref": "#/$defs/NoteRecord"
},
"title": "Notes",
"type": "array"
},
"events": {
"items": {
"$ref": "#/$defs/WireEvent"
},
"title": "Events",
"type": "array"
},
"curves": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Curves",
"type": "array"
},
"tempo_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"meter_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"coverage": {
"additionalProperties": true,
"title": "Coverage",
"type": "object"
},
"provenance": {
"additionalProperties": true,
"title": "Provenance",
"type": "object"
}
},
"required": [
"schema",
"material_id",
"revision_sha256",
"parent_revision",
"sources",
"tracks",
"clips",
"notes",
"events",
"curves",
"tempo_map_ref",
"meter_map_ref",
"coverage",
"provenance"
],
"title": "MaterialRecord",
"type": "object"
},
"NoteRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"voice_id": {
"title": "Voice Id",
"type": "string"
},
"role_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Role Ref"
},
"onset": {
"$ref": "#/$defs/Position"
},
"duration_qn": {
"$ref": "#/$defs/Rational"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
},
"velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"release_velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"mute": {
"title": "Mute",
"type": "boolean"
},
"expression_refs": {
"items": {
"type": "string"
},
"title": "Expression Refs",
"type": "array"
},
"source_binding": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Source Binding"
},
"derived_from": {
"items": {
"type": "string"
},
"title": "Derived From",
"type": "array"
}
},
"required": [
"id",
"voice_id",
"role_ref",
"onset",
"duration_qn",
"pitch",
"velocity",
"release_velocity",
"channel",
"mute",
"expression_refs",
"source_binding",
"derived_from"
],
"title": "NoteRecord",
"type": "object"
},
"PhraseNode": {
"additionalProperties": false,
"properties": {
"node_id": {
"title": "Node Id",
"type": "string"
},
"kind": {
"enum": [
"phrase",
"motif_reference"
],
"title": "Kind",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
},
"material_key": {
"title": "Material Key",
"type": "string"
},
"material_revision": {
"title": "Material Revision",
"type": "string"
},
"clip_id": {
"title": "Clip Id",
"type": "string"
},
"space": {
"const": "clip_qn",
"title": "Space",
"type": "string"
},
"span_qn": {
"$ref": "#/$defs/PhraseSpan"
},
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"attribution": {
"$ref": "#/$defs/StructureAttribution"
}
},
"required": [
"node_id",
"kind",
"label",
"material_key",
"material_revision",
"clip_id",
"space",
"span_qn",
"note_ids",
"attribution"
],
"title": "PhraseNode",
"type": "object"
},
"PhraseRelation": {
"additionalProperties": false,
"properties": {
"relation_id": {
"title": "Relation Id",
"type": "string"
},
"from_node": {
"title": "From Node",
"type": "string"
},
"to_node": {
"title": "To Node",
"type": "string"
},
"kind": {
"enum": [
"sequence",
"repeat",
"variation",
"withhold",
"return",
"call_response",
"motif_reference",
"derivation"
],
"title": "Kind",
"type": "string"
},
"identity_claims": {
"items": {
"enum": [
"exact_events",
"rhythm",
"pitch_intervals",
"accents",
"perceptual"
],
"type": "string"
},
"title": "Identity Claims",
"type": "array"
},
"attribution": {
"$ref": "#/$defs/StructureAttribution"
}
},
"required": [
"relation_id",
"from_node",
"to_node",
"kind",
"identity_claims",
"attribution"
],
"title": "PhraseRelation",
"type": "object"
},
"PhraseSpan": {
"additionalProperties": false,
"properties": {
"start": {
"$ref": "#/$defs/Rational"
},
"end": {
"$ref": "#/$defs/Rational"
}
},
"required": [
"start",
"end"
],
"title": "PhraseSpan",
"type": "object"
},
"PitchRecord": {
"additionalProperties": false,
"properties": {
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
}
],
"title": "Cents Offset"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"midi_note",
"cents_offset",
"tuning_ref"
],
"title": "PitchRecord",
"type": "object"
},
"Position": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
},
"space": {
"enum": [
"clip_qn",
"phrase_qn",
"arrangement_qn"
],
"title": "Space",
"type": "string"
}
},
"required": [
"n",
"d",
"space"
],
"title": "Position",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"StructureAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
},
"evidence": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Evidence",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty",
"evidence"
],
"title": "StructureAttribution",
"type": "object"
},
"StructureDefinition": {
"additionalProperties": false,
"properties": {
"label": {
"title": "Label",
"type": "string"
},
"materials": {
"items": {
"$ref": "#/$defs/MaterialBinding"
},
"title": "Materials",
"type": "array"
},
"nodes": {
"items": {
"$ref": "#/$defs/PhraseNode"
},
"title": "Nodes",
"type": "array"
},
"relations": {
"items": {
"$ref": "#/$defs/PhraseRelation"
},
"title": "Relations",
"type": "array"
},
"attribution": {
"$ref": "#/$defs/StructureAttribution"
},
"cycle_policy": {
"const": "reject",
"title": "Cycle Policy",
"type": "string"
},
"parent_structure": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
}
},
"required": [
"label",
"materials",
"nodes",
"relations",
"attribution",
"cycle_policy"
],
"title": "StructureDefinition",
"type": "object"
},
"VelocityRecord": {
"additionalProperties": false,
"properties": {
"value": {
"title": "Value",
"type": "integer"
},
"domain": {
"const": "midi1_7bit",
"title": "Domain",
"type": "string"
}
},
"required": [
"value",
"domain"
],
"title": "VelocityRecord",
"type": "object"
},
"WireEvent": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"time": {
"$ref": "#/$defs/Position"
},
"order": {
"title": "Order",
"type": "integer"
},
"message_type": {
"title": "Message Type",
"type": "string"
},
"is_meta": {
"title": "Is Meta",
"type": "boolean"
},
"bytes": {
"items": {
"type": "integer"
},
"title": "Bytes",
"type": "array"
},
"source_tick": {
"title": "Source Tick",
"type": "integer"
},
"track_index": {
"title": "Track Index",
"type": "integer"
}
},
"required": [
"id",
"time",
"order",
"message_type",
"is_meta",
"bytes"
],
"title": "WireEvent",
"type": "object"
}
},
"properties": {
"operation": {
"enum": [
"create",
"query"
],
"title": "Operation",
"type": "string"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Request Id"
},
"definition": {
"anyOf": [
{
"$ref": "#/$defs/StructureDefinition"
},
{
"type": "null"
}
],
"default": null
},
"structure": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"section": {
"default": "summary",
"enum": [
"summary",
"nodes",
"relations",
"members"
],
"title": "Section",
"type": "string"
},
"node_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Node Ids"
},
"limit": {
"default": 64,
"title": "Limit",
"type": "integer"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cursor"
},
"max_bytes": {
"default": 16000,
"title": "Max Bytes",
"type": "integer"
}
},
"required": [
"operation",
"store_root"
],
"title": "material_structureArguments",
"type": "object",
"additionalProperties": false
}midi_analyze Symbolic statistics, declared-voice intervals and role gate relationships.
Domain: midi. Read only: true.
Python
pocket_music.midi_analysis.midi_analyze(material: 'ArtifactHandle | MaterialRecord', store_root: 'str', selection: 'MaterialSelection | None' = None, analyses: 'list[str] | None' = None) -> 'dict'CLI
pocket midi-analyze --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ClipRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"$ref": "#/$defs/Rational"
},
"loop": {
"const": false,
"title": "Loop",
"type": "boolean"
},
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"event_ids": {
"items": {
"type": "string"
},
"title": "Event Ids",
"type": "array"
},
"curve_ids": {
"items": {
"type": "string"
},
"title": "Curve Ids",
"type": "array"
}
},
"required": [
"id",
"track_id",
"origin",
"length_qn",
"loop",
"note_ids",
"event_ids",
"curve_ids"
],
"title": "ClipRecord",
"type": "object"
},
"MaterialRecord": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.material/v1",
"title": "Schema",
"type": "string"
},
"material_id": {
"title": "Material Id",
"type": "string"
},
"revision_sha256": {
"title": "Revision Sha256",
"type": "string"
},
"parent_revision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Revision"
},
"sources": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Sources",
"type": "array"
},
"tracks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Tracks",
"type": "array"
},
"clips": {
"items": {
"$ref": "#/$defs/ClipRecord"
},
"title": "Clips",
"type": "array"
},
"notes": {
"items": {
"$ref": "#/$defs/NoteRecord"
},
"title": "Notes",
"type": "array"
},
"events": {
"items": {
"$ref": "#/$defs/WireEvent"
},
"title": "Events",
"type": "array"
},
"curves": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Curves",
"type": "array"
},
"tempo_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"meter_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"coverage": {
"additionalProperties": true,
"title": "Coverage",
"type": "object"
},
"provenance": {
"additionalProperties": true,
"title": "Provenance",
"type": "object"
}
},
"required": [
"schema",
"material_id",
"revision_sha256",
"parent_revision",
"sources",
"tracks",
"clips",
"notes",
"events",
"curves",
"tempo_map_ref",
"meter_map_ref",
"coverage",
"provenance"
],
"title": "MaterialRecord",
"type": "object"
},
"MaterialSelection": {
"additionalProperties": false,
"properties": {
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"voice_ids": {
"items": {
"type": "string"
},
"title": "Voice Ids",
"type": "array"
},
"clip_ids": {
"items": {
"type": "string"
},
"title": "Clip Ids",
"type": "array"
},
"span_qn": {
"items": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
]
},
"title": "Span Qn",
"type": "array"
},
"time_space": {
"const": "clip_qn",
"title": "Time Space",
"type": "string"
},
"material_revision": {
"title": "Material Revision",
"type": "string"
},
"selection_sha256": {
"title": "Selection Sha256",
"type": "string"
}
},
"title": "MaterialSelection",
"type": "object"
},
"NoteRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"voice_id": {
"title": "Voice Id",
"type": "string"
},
"role_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Role Ref"
},
"onset": {
"$ref": "#/$defs/Position"
},
"duration_qn": {
"$ref": "#/$defs/Rational"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
},
"velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"release_velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"mute": {
"title": "Mute",
"type": "boolean"
},
"expression_refs": {
"items": {
"type": "string"
},
"title": "Expression Refs",
"type": "array"
},
"source_binding": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Source Binding"
},
"derived_from": {
"items": {
"type": "string"
},
"title": "Derived From",
"type": "array"
}
},
"required": [
"id",
"voice_id",
"role_ref",
"onset",
"duration_qn",
"pitch",
"velocity",
"release_velocity",
"channel",
"mute",
"expression_refs",
"source_binding",
"derived_from"
],
"title": "NoteRecord",
"type": "object"
},
"PitchRecord": {
"additionalProperties": false,
"properties": {
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
}
],
"title": "Cents Offset"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"midi_note",
"cents_offset",
"tuning_ref"
],
"title": "PitchRecord",
"type": "object"
},
"Position": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
},
"space": {
"enum": [
"clip_qn",
"phrase_qn",
"arrangement_qn"
],
"title": "Space",
"type": "string"
}
},
"required": [
"n",
"d",
"space"
],
"title": "Position",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"VelocityRecord": {
"additionalProperties": false,
"properties": {
"value": {
"title": "Value",
"type": "integer"
},
"domain": {
"const": "midi1_7bit",
"title": "Domain",
"type": "string"
}
},
"required": [
"value",
"domain"
],
"title": "VelocityRecord",
"type": "object"
},
"WireEvent": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"time": {
"$ref": "#/$defs/Position"
},
"order": {
"title": "Order",
"type": "integer"
},
"message_type": {
"title": "Message Type",
"type": "string"
},
"is_meta": {
"title": "Is Meta",
"type": "boolean"
},
"bytes": {
"items": {
"type": "integer"
},
"title": "Bytes",
"type": "array"
},
"source_tick": {
"title": "Source Tick",
"type": "integer"
},
"track_index": {
"title": "Track Index",
"type": "integer"
}
},
"required": [
"id",
"time",
"order",
"message_type",
"is_meta",
"bytes"
],
"title": "WireEvent",
"type": "object"
}
},
"properties": {
"material": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/MaterialRecord"
}
],
"title": "Material"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"selection": {
"anyOf": [
{
"$ref": "#/$defs/MaterialSelection"
},
{
"type": "null"
}
],
"default": null
},
"analyses": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Analyses"
}
},
"required": [
"material",
"store_root"
],
"title": "midi_analyzeArguments",
"type": "object",
"additionalProperties": false
}midi_generate Deterministic explicit patterns, alternatives and no addition.
Domain: midi. Read only: false.
Python
pocket_music.midi_generate.midi_generate(brief: 'PatternBrief', store_root: 'str', request_id: 'str', seeds: 'SeedMap | None' = None, alternatives: 'int' = 2) -> 'dict'CLI
pocket midi-generate --spec <arguments.json>MCP input schema
{
"$defs": {
"PatternBrief": {
"additionalProperties": false,
"properties": {
"role": {
"title": "Role",
"type": "string"
},
"pitch": {
"title": "Pitch",
"type": "integer"
},
"cell_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Cell Qn"
},
"cell": {
"items": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
]
},
"title": "Cell",
"type": "array"
},
"length_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Length Qn"
},
"enter_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Enter Qn"
},
"exit_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Exit Qn"
},
"gate_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Gate Qn"
},
"velocities": {
"items": {
"type": "integer"
},
"title": "Velocities",
"type": "array"
},
"variation_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Variation Qn"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"intentions": {
"items": {
"type": "string"
},
"title": "Intentions",
"type": "array"
}
},
"required": [
"role",
"pitch",
"cell_qn",
"cell",
"length_qn"
],
"title": "PatternBrief",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"SeedMap": {
"additionalProperties": false,
"properties": {
"structure": {
"title": "Structure",
"type": "integer"
},
"timing": {
"title": "Timing",
"type": "integer"
},
"velocity": {
"title": "Velocity",
"type": "integer"
}
},
"title": "SeedMap",
"type": "object"
}
},
"properties": {
"brief": {
"$ref": "#/$defs/PatternBrief"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"seeds": {
"anyOf": [
{
"$ref": "#/$defs/SeedMap"
},
{
"type": "null"
}
],
"default": null
},
"alternatives": {
"default": 2,
"title": "Alternatives",
"type": "integer"
}
},
"required": [
"brief",
"store_root",
"request_id"
],
"title": "midi_generateArguments",
"type": "object",
"additionalProperties": false
}midi_develop Bounded explicit motif repetitions and seeded endpoint alternatives through public providers.
Domain: midi. Read only: false.
Python
pocket_music.midi_develop.midi_develop(*, store_root: 'str', request_id: 'str', definition: 'DevelopmentDefinition') -> 'dict'CLI
pocket midi-develop --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ClipRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"$ref": "#/$defs/Rational"
},
"loop": {
"const": false,
"title": "Loop",
"type": "boolean"
},
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"event_ids": {
"items": {
"type": "string"
},
"title": "Event Ids",
"type": "array"
},
"curve_ids": {
"items": {
"type": "string"
},
"title": "Curve Ids",
"type": "array"
}
},
"required": [
"id",
"track_id",
"origin",
"length_qn",
"loop",
"note_ids",
"event_ids",
"curve_ids"
],
"title": "ClipRecord",
"type": "object"
},
"DevelopmentDefinition": {
"additionalProperties": false,
"properties": {
"label": {
"title": "Label",
"type": "string"
},
"seed": {
"$ref": "#/$defs/DevelopmentSeed"
},
"clock": {
"$ref": "#/$defs/TimeContext"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Length Qn"
},
"occurrences": {
"items": {
"$ref": "#/$defs/DevelopmentOccurrence"
},
"title": "Occurrences",
"type": "array"
},
"locked_occurrence_id": {
"title": "Locked Occurrence Id",
"type": "string"
},
"endpoint_note_id": {
"title": "Endpoint Note Id",
"type": "string"
},
"eligible_occurrence_ids": {
"items": {
"type": "string"
},
"title": "Eligible Occurrence Ids",
"type": "array"
},
"variation": {
"$ref": "#/$defs/DevelopmentVariation"
},
"seeds": {
"$ref": "#/$defs/DevelopmentSeeds"
}
},
"required": [
"label",
"seed",
"clock",
"origin",
"length_qn",
"occurrences",
"locked_occurrence_id",
"endpoint_note_id",
"eligible_occurrence_ids",
"variation",
"seeds"
],
"title": "DevelopmentDefinition",
"type": "object"
},
"DevelopmentOccurrence": {
"additionalProperties": false,
"properties": {
"occurrence_id": {
"title": "Occurrence Id",
"type": "string"
},
"at_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "At Qn"
}
},
"required": [
"occurrence_id",
"at_qn"
],
"title": "DevelopmentOccurrence",
"type": "object"
},
"DevelopmentSeed": {
"additionalProperties": false,
"properties": {
"material": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/MaterialRecord"
}
],
"title": "Material"
},
"material_revision": {
"title": "Material Revision",
"type": "string"
},
"clip_id": {
"title": "Clip Id",
"type": "string"
}
},
"required": [
"material",
"material_revision",
"clip_id"
],
"title": "DevelopmentSeed",
"type": "object"
},
"DevelopmentSeeds": {
"additionalProperties": false,
"properties": {
"structure": {
"title": "Structure",
"type": "integer"
},
"pitch": {
"title": "Pitch",
"type": "integer"
},
"timing": {
"title": "Timing",
"type": "integer"
}
},
"required": [
"structure",
"pitch",
"timing"
],
"title": "DevelopmentSeeds",
"type": "object"
},
"DevelopmentVariation": {
"additionalProperties": false,
"properties": {
"pitch_offsets_semitones": {
"items": {
"type": "integer"
},
"title": "Pitch Offsets Semitones",
"type": "array"
},
"timing_offsets_qn": {
"items": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
]
},
"title": "Timing Offsets Qn",
"type": "array"
},
"max_changed_notes": {
"title": "Max Changed Notes",
"type": "integer"
},
"pitch_min": {
"title": "Pitch Min",
"type": "integer"
},
"pitch_max": {
"title": "Pitch Max",
"type": "integer"
}
},
"required": [
"pitch_offsets_semitones",
"timing_offsets_qn",
"max_changed_notes",
"pitch_min",
"pitch_max"
],
"title": "DevelopmentVariation",
"type": "object"
},
"MaterialRecord": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.material/v1",
"title": "Schema",
"type": "string"
},
"material_id": {
"title": "Material Id",
"type": "string"
},
"revision_sha256": {
"title": "Revision Sha256",
"type": "string"
},
"parent_revision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Revision"
},
"sources": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Sources",
"type": "array"
},
"tracks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Tracks",
"type": "array"
},
"clips": {
"items": {
"$ref": "#/$defs/ClipRecord"
},
"title": "Clips",
"type": "array"
},
"notes": {
"items": {
"$ref": "#/$defs/NoteRecord"
},
"title": "Notes",
"type": "array"
},
"events": {
"items": {
"$ref": "#/$defs/WireEvent"
},
"title": "Events",
"type": "array"
},
"curves": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Curves",
"type": "array"
},
"tempo_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"meter_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"coverage": {
"additionalProperties": true,
"title": "Coverage",
"type": "object"
},
"provenance": {
"additionalProperties": true,
"title": "Provenance",
"type": "object"
}
},
"required": [
"schema",
"material_id",
"revision_sha256",
"parent_revision",
"sources",
"tracks",
"clips",
"notes",
"events",
"curves",
"tempo_map_ref",
"meter_map_ref",
"coverage",
"provenance"
],
"title": "MaterialRecord",
"type": "object"
},
"NoteRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"voice_id": {
"title": "Voice Id",
"type": "string"
},
"role_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Role Ref"
},
"onset": {
"$ref": "#/$defs/Position"
},
"duration_qn": {
"$ref": "#/$defs/Rational"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
},
"velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"release_velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"mute": {
"title": "Mute",
"type": "boolean"
},
"expression_refs": {
"items": {
"type": "string"
},
"title": "Expression Refs",
"type": "array"
},
"source_binding": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Source Binding"
},
"derived_from": {
"items": {
"type": "string"
},
"title": "Derived From",
"type": "array"
}
},
"required": [
"id",
"voice_id",
"role_ref",
"onset",
"duration_qn",
"pitch",
"velocity",
"release_velocity",
"channel",
"mute",
"expression_refs",
"source_binding",
"derived_from"
],
"title": "NoteRecord",
"type": "object"
},
"PitchRecord": {
"additionalProperties": false,
"properties": {
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
}
],
"title": "Cents Offset"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"midi_note",
"cents_offset",
"tuning_ref"
],
"title": "PitchRecord",
"type": "object"
},
"Position": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
},
"space": {
"enum": [
"clip_qn",
"phrase_qn",
"arrangement_qn"
],
"title": "Space",
"type": "string"
}
},
"required": [
"n",
"d",
"space"
],
"title": "Position",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"TimeContext": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.time-context/v1",
"title": "Schema",
"type": "string"
},
"context_id": {
"title": "Context Id",
"type": "string"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"source": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"schema",
"context_id",
"attribution"
],
"title": "TimeContext",
"type": "object"
},
"VelocityRecord": {
"additionalProperties": false,
"properties": {
"value": {
"title": "Value",
"type": "integer"
},
"domain": {
"const": "midi1_7bit",
"title": "Domain",
"type": "string"
}
},
"required": [
"value",
"domain"
],
"title": "VelocityRecord",
"type": "object"
},
"WireEvent": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"time": {
"$ref": "#/$defs/Position"
},
"order": {
"title": "Order",
"type": "integer"
},
"message_type": {
"title": "Message Type",
"type": "string"
},
"is_meta": {
"title": "Is Meta",
"type": "boolean"
},
"bytes": {
"items": {
"type": "integer"
},
"title": "Bytes",
"type": "array"
},
"source_tick": {
"title": "Source Tick",
"type": "integer"
},
"track_index": {
"title": "Track Index",
"type": "integer"
}
},
"required": [
"id",
"time",
"order",
"message_type",
"is_meta",
"bytes"
],
"title": "WireEvent",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"definition": {
"$ref": "#/$defs/DevelopmentDefinition"
}
},
"required": [
"store_root",
"request_id",
"definition"
],
"title": "midi_developArguments",
"type": "object",
"additionalProperties": false
}midi_arrangement_develop Develop explicit whole-clip sections from an attributed graph, retaining exact locks and unchanged alternatives.
Domain: midi. Read only: false.
Python
pocket_music.arrangement_develop.midi_arrangement_develop(*, store_root: 'str', request_id: 'str', definition: 'ArrangementDefinition') -> 'dict'CLI
pocket midi-arrangement-develop --spec <arguments.json>MCP input schema
{
"$defs": {
"ArrangementDefinition": {
"additionalProperties": false,
"properties": {
"label": {
"title": "Label",
"type": "string"
},
"structure": {
"$ref": "#/$defs/ArtifactHandle"
},
"expected_structure_revision": {
"title": "Expected Structure Revision",
"type": "string"
},
"clock": {
"$ref": "#/$defs/TimeContext"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Length Qn"
},
"sections": {
"items": {
"$ref": "#/$defs/ArrangementSection"
},
"title": "Sections",
"type": "array"
},
"locked_section_ids": {
"items": {
"type": "string"
},
"title": "Locked Section Ids",
"type": "array"
},
"variations": {
"items": {
"$ref": "#/$defs/ArrangementVariation"
},
"title": "Variations",
"type": "array"
},
"seeds": {
"$ref": "#/$defs/DevelopmentSeeds"
},
"attribution": {
"$ref": "#/$defs/StructureAttribution"
}
},
"required": [
"label",
"structure",
"expected_structure_revision",
"clock",
"origin",
"length_qn",
"sections",
"locked_section_ids",
"variations",
"seeds",
"attribution"
],
"title": "ArrangementDefinition",
"type": "object"
},
"ArrangementSection": {
"additionalProperties": false,
"properties": {
"section_id": {
"title": "Section Id",
"type": "string"
},
"node_id": {
"title": "Node Id",
"type": "string"
},
"at_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "At Qn"
}
},
"required": [
"section_id",
"node_id",
"at_qn"
],
"title": "ArrangementSection",
"type": "object"
},
"ArrangementVariation": {
"additionalProperties": false,
"properties": {
"section_id": {
"title": "Section Id",
"type": "string"
},
"endpoint_note_id": {
"title": "Endpoint Note Id",
"type": "string"
},
"pitch_offsets_semitones": {
"items": {
"type": "integer"
},
"title": "Pitch Offsets Semitones",
"type": "array"
},
"timing_offsets_qn": {
"items": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
]
},
"title": "Timing Offsets Qn",
"type": "array"
},
"pitch_min": {
"title": "Pitch Min",
"type": "integer"
},
"pitch_max": {
"title": "Pitch Max",
"type": "integer"
}
},
"required": [
"section_id",
"endpoint_note_id",
"pitch_offsets_semitones",
"timing_offsets_qn",
"pitch_min",
"pitch_max"
],
"title": "ArrangementVariation",
"type": "object"
},
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"DevelopmentSeeds": {
"additionalProperties": false,
"properties": {
"structure": {
"title": "Structure",
"type": "integer"
},
"pitch": {
"title": "Pitch",
"type": "integer"
},
"timing": {
"title": "Timing",
"type": "integer"
}
},
"required": [
"structure",
"pitch",
"timing"
],
"title": "DevelopmentSeeds",
"type": "object"
},
"Position": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
},
"space": {
"enum": [
"clip_qn",
"phrase_qn",
"arrangement_qn"
],
"title": "Space",
"type": "string"
}
},
"required": [
"n",
"d",
"space"
],
"title": "Position",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"StructureAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
},
"evidence": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Evidence",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty",
"evidence"
],
"title": "StructureAttribution",
"type": "object"
},
"TimeContext": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.time-context/v1",
"title": "Schema",
"type": "string"
},
"context_id": {
"title": "Context Id",
"type": "string"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"source": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"schema",
"context_id",
"attribution"
],
"title": "TimeContext",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"definition": {
"$ref": "#/$defs/ArrangementDefinition"
}
},
"required": [
"store_root",
"request_id",
"definition"
],
"title": "midi_arrangement_developArguments",
"type": "object",
"additionalProperties": false
}midi_arrangement_query Query revision-bound sections and sparse changes with verified source and identity proofs.
Domain: midi. Read only: true.
Python
pocket_music.arrangement_develop.midi_arrangement_query(*, store_root: 'str', development: 'ArtifactHandle', view: "Literal['summary', 'sections', 'changes']" = 'summary', limit: 'int' = 32, cursor: 'str | None' = None, max_bytes: 'int' = 16384) -> 'dict'CLI
pocket midi-arrangement-query --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"development": {
"$ref": "#/$defs/ArtifactHandle"
},
"view": {
"default": "summary",
"enum": [
"summary",
"sections",
"changes"
],
"title": "View",
"type": "string"
},
"limit": {
"default": 32,
"title": "Limit",
"type": "integer"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cursor"
},
"max_bytes": {
"default": 16384,
"title": "Max Bytes",
"type": "integer"
}
},
"required": [
"store_root",
"development"
],
"title": "midi_arrangement_queryArguments",
"type": "object",
"additionalProperties": false
}midi_timing_alternatives Compose explicitly matched authored audio evidence and declared clocks through exact public note shifts; retain unchanged music.
Domain: midi. Read only: false.
Python
pocket_music.midi_timing_alternatives.midi_timing_alternatives(*, store_root: 'str', request_id: 'str', material: 'ArtifactHandle | MaterialRecord', selection: 'MaterialSelection', hypotheses: 'ArtifactHandle', expected_hypotheses_revision: 'str', alignment: 'TimingAlignment', alternatives: 'list[TimingAlternative]', locks: 'MaterialLocks', attribution: 'AudioHypothesisAttribution') -> 'dict'CLI
pocket midi-timing-alternatives --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"AttackPoint": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "annotation_attack",
"title": "Kind",
"type": "string"
}
},
"required": [
"kind"
],
"title": "AttackPoint",
"type": "object"
},
"AudioHypothesisAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "AudioHypothesisAttribution",
"type": "object"
},
"ClipRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"$ref": "#/$defs/Rational"
},
"loop": {
"const": false,
"title": "Loop",
"type": "boolean"
},
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"event_ids": {
"items": {
"type": "string"
},
"title": "Event Ids",
"type": "array"
},
"curve_ids": {
"items": {
"type": "string"
},
"title": "Curve Ids",
"type": "array"
}
},
"required": [
"id",
"track_id",
"origin",
"length_qn",
"loop",
"note_ids",
"event_ids",
"curve_ids"
],
"title": "ClipRecord",
"type": "object"
},
"MaterialLocks": {
"additionalProperties": false,
"properties": {
"outside_selection": {
"const": "all",
"title": "Outside Selection",
"type": "string"
},
"selected_fields": {
"items": {
"type": "string"
},
"title": "Selected Fields",
"type": "array"
}
},
"title": "MaterialLocks",
"type": "object"
},
"MaterialRecord": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.material/v1",
"title": "Schema",
"type": "string"
},
"material_id": {
"title": "Material Id",
"type": "string"
},
"revision_sha256": {
"title": "Revision Sha256",
"type": "string"
},
"parent_revision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Revision"
},
"sources": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Sources",
"type": "array"
},
"tracks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Tracks",
"type": "array"
},
"clips": {
"items": {
"$ref": "#/$defs/ClipRecord"
},
"title": "Clips",
"type": "array"
},
"notes": {
"items": {
"$ref": "#/$defs/NoteRecord"
},
"title": "Notes",
"type": "array"
},
"events": {
"items": {
"$ref": "#/$defs/WireEvent"
},
"title": "Events",
"type": "array"
},
"curves": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Curves",
"type": "array"
},
"tempo_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"meter_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"coverage": {
"additionalProperties": true,
"title": "Coverage",
"type": "object"
},
"provenance": {
"additionalProperties": true,
"title": "Provenance",
"type": "object"
}
},
"required": [
"schema",
"material_id",
"revision_sha256",
"parent_revision",
"sources",
"tracks",
"clips",
"notes",
"events",
"curves",
"tempo_map_ref",
"meter_map_ref",
"coverage",
"provenance"
],
"title": "MaterialRecord",
"type": "object"
},
"MaterialSelection": {
"additionalProperties": false,
"properties": {
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"voice_ids": {
"items": {
"type": "string"
},
"title": "Voice Ids",
"type": "array"
},
"clip_ids": {
"items": {
"type": "string"
},
"title": "Clip Ids",
"type": "array"
},
"span_qn": {
"items": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
]
},
"title": "Span Qn",
"type": "array"
},
"time_space": {
"const": "clip_qn",
"title": "Time Space",
"type": "string"
},
"material_revision": {
"title": "Material Revision",
"type": "string"
},
"selection_sha256": {
"title": "Selection Sha256",
"type": "string"
}
},
"title": "MaterialSelection",
"type": "object"
},
"NoteRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"voice_id": {
"title": "Voice Id",
"type": "string"
},
"role_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Role Ref"
},
"onset": {
"$ref": "#/$defs/Position"
},
"duration_qn": {
"$ref": "#/$defs/Rational"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
},
"velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"release_velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"mute": {
"title": "Mute",
"type": "boolean"
},
"expression_refs": {
"items": {
"type": "string"
},
"title": "Expression Refs",
"type": "array"
},
"source_binding": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Source Binding"
},
"derived_from": {
"items": {
"type": "string"
},
"title": "Derived From",
"type": "array"
}
},
"required": [
"id",
"voice_id",
"role_ref",
"onset",
"duration_qn",
"pitch",
"velocity",
"release_velocity",
"channel",
"mute",
"expression_refs",
"source_binding",
"derived_from"
],
"title": "NoteRecord",
"type": "object"
},
"PitchRecord": {
"additionalProperties": false,
"properties": {
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
}
],
"title": "Cents Offset"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"midi_note",
"cents_offset",
"tuning_ref"
],
"title": "PitchRecord",
"type": "object"
},
"Position": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
},
"space": {
"enum": [
"clip_qn",
"phrase_qn",
"arrangement_qn"
],
"title": "Space",
"type": "string"
}
},
"required": [
"n",
"d",
"space"
],
"title": "Position",
"type": "object"
},
"PulsePoint": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "declared_pulse_point",
"title": "Kind",
"type": "string"
},
"original_source_frame_q": {
"$ref": "#/$defs/Rational"
},
"statement": {
"title": "Statement",
"type": "string"
}
},
"required": [
"kind",
"original_source_frame_q",
"statement"
],
"title": "PulsePoint",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"TimingAlignment": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "declared_unwarped_source_clock",
"title": "Kind",
"type": "string"
},
"original_sha256": {
"title": "Original Sha256",
"type": "string"
},
"sample_rate": {
"title": "Sample Rate",
"type": "integer"
},
"source_anchor_frame_q": {
"$ref": "#/$defs/Rational"
},
"host_anchor_seconds_q": {
"$ref": "#/$defs/Rational"
},
"time_map": {
"$ref": "#/$defs/ArtifactHandle"
},
"clip_id": {
"title": "Clip Id",
"type": "string"
}
},
"required": [
"kind",
"original_sha256",
"sample_rate",
"source_anchor_frame_q",
"host_anchor_seconds_q",
"time_map",
"clip_id"
],
"title": "TimingAlignment",
"type": "object"
},
"TimingAlternative": {
"additionalProperties": false,
"properties": {
"alternative_id": {
"title": "Alternative Id",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
},
"strength": {
"$ref": "#/$defs/Rational"
},
"maximum_shift_qn": {
"$ref": "#/$defs/Rational"
},
"matches": {
"items": {
"$ref": "#/$defs/TimingMatch"
},
"title": "Matches",
"type": "array"
}
},
"required": [
"alternative_id",
"statement",
"uncertainty",
"strength",
"maximum_shift_qn",
"matches"
],
"title": "TimingAlternative",
"type": "object"
},
"TimingMatch": {
"additionalProperties": false,
"properties": {
"note_id": {
"title": "Note Id",
"type": "string"
},
"annotation_id": {
"title": "Annotation Id",
"type": "string"
},
"point": {
"anyOf": [
{
"$ref": "#/$defs/AttackPoint"
},
{
"$ref": "#/$defs/PulsePoint"
}
],
"title": "Point"
}
},
"required": [
"note_id",
"annotation_id",
"point"
],
"title": "TimingMatch",
"type": "object"
},
"VelocityRecord": {
"additionalProperties": false,
"properties": {
"value": {
"title": "Value",
"type": "integer"
},
"domain": {
"const": "midi1_7bit",
"title": "Domain",
"type": "string"
}
},
"required": [
"value",
"domain"
],
"title": "VelocityRecord",
"type": "object"
},
"WireEvent": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"time": {
"$ref": "#/$defs/Position"
},
"order": {
"title": "Order",
"type": "integer"
},
"message_type": {
"title": "Message Type",
"type": "string"
},
"is_meta": {
"title": "Is Meta",
"type": "boolean"
},
"bytes": {
"items": {
"type": "integer"
},
"title": "Bytes",
"type": "array"
},
"source_tick": {
"title": "Source Tick",
"type": "integer"
},
"track_index": {
"title": "Track Index",
"type": "integer"
}
},
"required": [
"id",
"time",
"order",
"message_type",
"is_meta",
"bytes"
],
"title": "WireEvent",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"material": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/MaterialRecord"
}
],
"title": "Material"
},
"selection": {
"$ref": "#/$defs/MaterialSelection"
},
"hypotheses": {
"$ref": "#/$defs/ArtifactHandle"
},
"expected_hypotheses_revision": {
"title": "Expected Hypotheses Revision",
"type": "string"
},
"alignment": {
"$ref": "#/$defs/TimingAlignment"
},
"alternatives": {
"items": {
"$ref": "#/$defs/TimingAlternative"
},
"title": "Alternatives",
"type": "array"
},
"locks": {
"$ref": "#/$defs/MaterialLocks"
},
"attribution": {
"$ref": "#/$defs/AudioHypothesisAttribution"
}
},
"required": [
"store_root",
"request_id",
"material",
"selection",
"hypotheses",
"expected_hypotheses_revision",
"alignment",
"alternatives",
"locks",
"attribution"
],
"title": "midi_timing_alternativesArguments",
"type": "object",
"additionalProperties": false
}midi_timing_query Query bounded timing proofs after isolated public-edit replay without source audio or a model runtime.
Domain: midi. Read only: true.
Python
pocket_music.midi_timing_alternatives.midi_timing_query(*, store_root: 'str', manifest: 'ArtifactHandle', view: "Literal['summary', 'matches', 'steps']" = 'summary', cursor: 'str | None' = None, limit: 'int' = 16, max_bytes: 'int' = 16000) -> 'dict'CLI
pocket midi-timing-query --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"manifest": {
"$ref": "#/$defs/ArtifactHandle"
},
"view": {
"default": "summary",
"enum": [
"summary",
"matches",
"steps"
],
"title": "View",
"type": "string"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cursor"
},
"limit": {
"default": 16,
"title": "Limit",
"type": "integer"
},
"max_bytes": {
"default": 16000,
"title": "Max Bytes",
"type": "integer"
}
},
"required": [
"store_root",
"manifest"
],
"title": "midi_timing_queryArguments",
"type": "object",
"additionalProperties": false
}midi_lifecycle Declared symbolic note/sustain/tail reservations; no receiver or allocation qualification.
Domain: midi. Read only: false.
Python
pocket_music.midi_lifecycle.midi_lifecycle(material: 'ArtifactHandle | MaterialRecord', clip_id: 'str', initial_state: 'LifecycleInitialState', horizon_qn: 'Rational | int', release_tail_qn: 'Rational | int', equal_time_order: "Literal['note_off_cc_note_on', 'cc_note_off_note_on']", source_basis: "Literal['canonical_notes_retained_cc64']", store_root: 'str', request_id: 'str') -> 'dict'CLI
pocket midi-lifecycle --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ClipRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"$ref": "#/$defs/Rational"
},
"loop": {
"const": false,
"title": "Loop",
"type": "boolean"
},
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"event_ids": {
"items": {
"type": "string"
},
"title": "Event Ids",
"type": "array"
},
"curve_ids": {
"items": {
"type": "string"
},
"title": "Curve Ids",
"type": "array"
}
},
"required": [
"id",
"track_id",
"origin",
"length_qn",
"loop",
"note_ids",
"event_ids",
"curve_ids"
],
"title": "ClipRecord",
"type": "object"
},
"InitialSustain": {
"additionalProperties": false,
"properties": {
"channel": {
"title": "Channel",
"type": "integer"
},
"value": {
"title": "Value",
"type": "integer"
}
},
"required": [
"channel",
"value"
],
"title": "InitialSustain",
"type": "object"
},
"LifecycleInitialState": {
"additionalProperties": false,
"properties": {
"active_notes": {
"const": "none",
"title": "Active Notes",
"type": "string"
},
"sustain": {
"items": {
"$ref": "#/$defs/InitialSustain"
},
"title": "Sustain",
"type": "array"
}
},
"required": [
"active_notes",
"sustain"
],
"title": "LifecycleInitialState",
"type": "object"
},
"MaterialRecord": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.material/v1",
"title": "Schema",
"type": "string"
},
"material_id": {
"title": "Material Id",
"type": "string"
},
"revision_sha256": {
"title": "Revision Sha256",
"type": "string"
},
"parent_revision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Revision"
},
"sources": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Sources",
"type": "array"
},
"tracks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Tracks",
"type": "array"
},
"clips": {
"items": {
"$ref": "#/$defs/ClipRecord"
},
"title": "Clips",
"type": "array"
},
"notes": {
"items": {
"$ref": "#/$defs/NoteRecord"
},
"title": "Notes",
"type": "array"
},
"events": {
"items": {
"$ref": "#/$defs/WireEvent"
},
"title": "Events",
"type": "array"
},
"curves": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Curves",
"type": "array"
},
"tempo_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"meter_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"coverage": {
"additionalProperties": true,
"title": "Coverage",
"type": "object"
},
"provenance": {
"additionalProperties": true,
"title": "Provenance",
"type": "object"
}
},
"required": [
"schema",
"material_id",
"revision_sha256",
"parent_revision",
"sources",
"tracks",
"clips",
"notes",
"events",
"curves",
"tempo_map_ref",
"meter_map_ref",
"coverage",
"provenance"
],
"title": "MaterialRecord",
"type": "object"
},
"NoteRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"voice_id": {
"title": "Voice Id",
"type": "string"
},
"role_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Role Ref"
},
"onset": {
"$ref": "#/$defs/Position"
},
"duration_qn": {
"$ref": "#/$defs/Rational"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
},
"velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"release_velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"mute": {
"title": "Mute",
"type": "boolean"
},
"expression_refs": {
"items": {
"type": "string"
},
"title": "Expression Refs",
"type": "array"
},
"source_binding": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Source Binding"
},
"derived_from": {
"items": {
"type": "string"
},
"title": "Derived From",
"type": "array"
}
},
"required": [
"id",
"voice_id",
"role_ref",
"onset",
"duration_qn",
"pitch",
"velocity",
"release_velocity",
"channel",
"mute",
"expression_refs",
"source_binding",
"derived_from"
],
"title": "NoteRecord",
"type": "object"
},
"PitchRecord": {
"additionalProperties": false,
"properties": {
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
}
],
"title": "Cents Offset"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"midi_note",
"cents_offset",
"tuning_ref"
],
"title": "PitchRecord",
"type": "object"
},
"Position": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
},
"space": {
"enum": [
"clip_qn",
"phrase_qn",
"arrangement_qn"
],
"title": "Space",
"type": "string"
}
},
"required": [
"n",
"d",
"space"
],
"title": "Position",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"VelocityRecord": {
"additionalProperties": false,
"properties": {
"value": {
"title": "Value",
"type": "integer"
},
"domain": {
"const": "midi1_7bit",
"title": "Domain",
"type": "string"
}
},
"required": [
"value",
"domain"
],
"title": "VelocityRecord",
"type": "object"
},
"WireEvent": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"time": {
"$ref": "#/$defs/Position"
},
"order": {
"title": "Order",
"type": "integer"
},
"message_type": {
"title": "Message Type",
"type": "string"
},
"is_meta": {
"title": "Is Meta",
"type": "boolean"
},
"bytes": {
"items": {
"type": "integer"
},
"title": "Bytes",
"type": "array"
},
"source_tick": {
"title": "Source Tick",
"type": "integer"
},
"track_index": {
"title": "Track Index",
"type": "integer"
}
},
"required": [
"id",
"time",
"order",
"message_type",
"is_meta",
"bytes"
],
"title": "WireEvent",
"type": "object"
}
},
"properties": {
"material": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/MaterialRecord"
}
],
"title": "Material"
},
"clip_id": {
"title": "Clip Id",
"type": "string"
},
"initial_state": {
"$ref": "#/$defs/LifecycleInitialState"
},
"horizon_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Horizon Qn"
},
"release_tail_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Release Tail Qn"
},
"equal_time_order": {
"enum": [
"note_off_cc_note_on",
"cc_note_off_note_on"
],
"title": "Equal Time Order",
"type": "string"
},
"source_basis": {
"const": "canonical_notes_retained_cc64",
"title": "Source Basis",
"type": "string"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"material",
"clip_id",
"initial_state",
"horizon_qn",
"release_tail_qn",
"equal_time_order",
"source_basis",
"store_root",
"request_id"
],
"title": "midi_lifecycleArguments",
"type": "object",
"additionalProperties": false
}midi_transform Literal notes, split/merge, selected edits, explicit grid/groove timing, dynamics and attributed revoicing with exact locks.
Domain: midi. Read only: false.
Python
pocket_music.midi_edit.midi_transform(material: 'ArtifactHandle | MaterialRecord', selection: 'MaterialSelection', operations: 'list[MaterialEditOperation]', store_root: 'str', request_id: 'str', locks: 'MaterialLocks | None' = None, expression_policy: 'str' = 'reject', overlap_policy: 'str' = 'reject_new') -> 'dict'CLI
pocket midi-transform --spec <arguments.json>MCP input schema
{
"$defs": {
"AddOperation": {
"additionalProperties": false,
"properties": {
"op": {
"const": "add",
"title": "Op",
"type": "string"
},
"clip_id": {
"title": "Clip Id",
"type": "string"
},
"notes": {
"items": {
"$ref": "#/$defs/LiteralNoteSpec"
},
"title": "Notes",
"type": "array"
},
"controller_timeline": {
"const": "preserve_existing",
"title": "Controller Timeline",
"type": "string"
},
"time_space": {
"const": "clip_qn",
"title": "Time Space",
"type": "string"
}
},
"required": [
"op",
"clip_id",
"notes",
"controller_timeline",
"time_space"
],
"title": "AddOperation",
"type": "object"
},
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ClipRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"$ref": "#/$defs/Rational"
},
"loop": {
"const": false,
"title": "Loop",
"type": "boolean"
},
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"event_ids": {
"items": {
"type": "string"
},
"title": "Event Ids",
"type": "array"
},
"curve_ids": {
"items": {
"type": "string"
},
"title": "Curve Ids",
"type": "array"
}
},
"required": [
"id",
"track_id",
"origin",
"length_qn",
"loop",
"note_ids",
"event_ids",
"curve_ids"
],
"title": "ClipRecord",
"type": "object"
},
"DeleteOperation": {
"additionalProperties": false,
"properties": {
"op": {
"const": "delete",
"title": "Op",
"type": "string"
},
"controller_timeline": {
"const": "preserve_existing",
"title": "Controller Timeline",
"type": "string"
}
},
"required": [
"op",
"controller_timeline"
],
"title": "DeleteOperation",
"type": "object"
},
"DuplicateOperation": {
"additionalProperties": false,
"properties": {
"op": {
"const": "duplicate",
"title": "Op",
"type": "string"
},
"delta_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Delta Qn"
},
"controller_timeline": {
"const": "preserve_existing",
"title": "Controller Timeline",
"type": "string"
}
},
"required": [
"op",
"delta_qn",
"controller_timeline"
],
"title": "DuplicateOperation",
"type": "object"
},
"EditOperation": {
"additionalProperties": false,
"properties": {
"op": {
"enum": [
"shift",
"transpose",
"repitch",
"velocity",
"release_velocity",
"resize",
"thin"
],
"title": "Op",
"type": "string"
},
"delta_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Delta Qn"
},
"semitones": {
"title": "Semitones",
"type": "integer"
},
"pitch": {
"title": "Pitch",
"type": "integer"
},
"value": {
"title": "Value",
"type": "integer"
},
"duration_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Duration Qn"
},
"every": {
"title": "Every",
"type": "integer"
},
"offset": {
"title": "Offset",
"type": "integer"
}
},
"required": [
"op"
],
"title": "EditOperation",
"type": "object"
},
"GridQuantizeOperation": {
"additionalProperties": false,
"properties": {
"op": {
"const": "grid_quantize",
"title": "Op",
"type": "string"
},
"grid_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Grid Qn"
},
"phase_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Phase Qn"
},
"strength": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Strength"
},
"threshold_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Threshold Qn"
},
"ties": {
"enum": [
"earlier",
"later"
],
"title": "Ties",
"type": "string"
},
"note_off": {
"const": "follow_onset",
"title": "Note Off",
"type": "string"
},
"controller_timeline": {
"const": "preserve_existing",
"title": "Controller Timeline",
"type": "string"
},
"time_space": {
"const": "clip_qn",
"title": "Time Space",
"type": "string"
}
},
"required": [
"op",
"grid_qn",
"phase_qn",
"strength",
"threshold_qn",
"ties",
"note_off",
"controller_timeline",
"time_space"
],
"title": "GridQuantizeOperation",
"type": "object"
},
"GrooveAnchor": {
"additionalProperties": false,
"properties": {
"nominal_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Nominal Qn"
},
"offset_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Offset Qn"
}
},
"required": [
"nominal_qn",
"offset_qn"
],
"title": "GrooveAnchor",
"type": "object"
},
"GrooveOperation": {
"additionalProperties": false,
"properties": {
"op": {
"const": "groove",
"title": "Op",
"type": "string"
},
"cycle_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Cycle Qn"
},
"anchors": {
"items": {
"$ref": "#/$defs/GrooveAnchor"
},
"title": "Anchors",
"type": "array"
},
"phase_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Phase Qn"
},
"strength": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Strength"
},
"threshold_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Threshold Qn"
},
"ties": {
"enum": [
"earlier",
"later"
],
"title": "Ties",
"type": "string"
},
"note_off": {
"const": "follow_onset",
"title": "Note Off",
"type": "string"
},
"controller_timeline": {
"const": "preserve_existing",
"title": "Controller Timeline",
"type": "string"
},
"time_space": {
"const": "clip_qn",
"title": "Time Space",
"type": "string"
}
},
"required": [
"op",
"cycle_qn",
"anchors",
"phase_qn",
"strength",
"threshold_qn",
"ties",
"note_off",
"controller_timeline",
"time_space"
],
"title": "GrooveOperation",
"type": "object"
},
"HarmonicHypothesis": {
"additionalProperties": false,
"properties": {
"label": {
"title": "Label",
"type": "string"
},
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"label",
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "HarmonicHypothesis",
"type": "object"
},
"LiteralNoteSpec": {
"additionalProperties": false,
"properties": {
"onset_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Onset Qn"
},
"duration_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Duration Qn"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
},
"velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"release_velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"mute": {
"title": "Mute",
"type": "boolean"
},
"voice_id": {
"title": "Voice Id",
"type": "string"
},
"role_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Role Ref"
}
},
"required": [
"onset_qn",
"duration_qn",
"pitch",
"velocity",
"release_velocity",
"channel",
"mute",
"voice_id",
"role_ref"
],
"title": "LiteralNoteSpec",
"type": "object"
},
"MaterialLocks": {
"additionalProperties": false,
"properties": {
"outside_selection": {
"const": "all",
"title": "Outside Selection",
"type": "string"
},
"selected_fields": {
"items": {
"type": "string"
},
"title": "Selected Fields",
"type": "array"
}
},
"title": "MaterialLocks",
"type": "object"
},
"MaterialRecord": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.material/v1",
"title": "Schema",
"type": "string"
},
"material_id": {
"title": "Material Id",
"type": "string"
},
"revision_sha256": {
"title": "Revision Sha256",
"type": "string"
},
"parent_revision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Revision"
},
"sources": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Sources",
"type": "array"
},
"tracks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Tracks",
"type": "array"
},
"clips": {
"items": {
"$ref": "#/$defs/ClipRecord"
},
"title": "Clips",
"type": "array"
},
"notes": {
"items": {
"$ref": "#/$defs/NoteRecord"
},
"title": "Notes",
"type": "array"
},
"events": {
"items": {
"$ref": "#/$defs/WireEvent"
},
"title": "Events",
"type": "array"
},
"curves": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Curves",
"type": "array"
},
"tempo_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"meter_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"coverage": {
"additionalProperties": true,
"title": "Coverage",
"type": "object"
},
"provenance": {
"additionalProperties": true,
"title": "Provenance",
"type": "object"
}
},
"required": [
"schema",
"material_id",
"revision_sha256",
"parent_revision",
"sources",
"tracks",
"clips",
"notes",
"events",
"curves",
"tempo_map_ref",
"meter_map_ref",
"coverage",
"provenance"
],
"title": "MaterialRecord",
"type": "object"
},
"MaterialSelection": {
"additionalProperties": false,
"properties": {
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"voice_ids": {
"items": {
"type": "string"
},
"title": "Voice Ids",
"type": "array"
},
"clip_ids": {
"items": {
"type": "string"
},
"title": "Clip Ids",
"type": "array"
},
"span_qn": {
"items": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
]
},
"title": "Span Qn",
"type": "array"
},
"time_space": {
"const": "clip_qn",
"title": "Time Space",
"type": "string"
},
"material_revision": {
"title": "Material Revision",
"type": "string"
},
"selection_sha256": {
"title": "Selection Sha256",
"type": "string"
}
},
"title": "MaterialSelection",
"type": "object"
},
"MergeOperation": {
"additionalProperties": false,
"properties": {
"op": {
"const": "merge",
"title": "Op",
"type": "string"
},
"controller_timeline": {
"const": "preserve_existing",
"title": "Controller Timeline",
"type": "string"
},
"time_space": {
"const": "clip_qn",
"title": "Time Space",
"type": "string"
},
"articulation": {
"const": "remove_retriggers",
"title": "Articulation",
"type": "string"
}
},
"required": [
"op",
"controller_timeline",
"time_space",
"articulation"
],
"title": "MergeOperation",
"type": "object"
},
"NotePitchDestination": {
"additionalProperties": false,
"properties": {
"note_id": {
"title": "Note Id",
"type": "string"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
}
},
"required": [
"note_id",
"pitch"
],
"title": "NotePitchDestination",
"type": "object"
},
"NoteRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"voice_id": {
"title": "Voice Id",
"type": "string"
},
"role_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Role Ref"
},
"onset": {
"$ref": "#/$defs/Position"
},
"duration_qn": {
"$ref": "#/$defs/Rational"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
},
"velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"release_velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"mute": {
"title": "Mute",
"type": "boolean"
},
"expression_refs": {
"items": {
"type": "string"
},
"title": "Expression Refs",
"type": "array"
},
"source_binding": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Source Binding"
},
"derived_from": {
"items": {
"type": "string"
},
"title": "Derived From",
"type": "array"
}
},
"required": [
"id",
"voice_id",
"role_ref",
"onset",
"duration_qn",
"pitch",
"velocity",
"release_velocity",
"channel",
"mute",
"expression_refs",
"source_binding",
"derived_from"
],
"title": "NoteRecord",
"type": "object"
},
"PitchRecord": {
"additionalProperties": false,
"properties": {
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
}
],
"title": "Cents Offset"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"midi_note",
"cents_offset",
"tuning_ref"
],
"title": "PitchRecord",
"type": "object"
},
"Position": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
},
"space": {
"enum": [
"clip_qn",
"phrase_qn",
"arrangement_qn"
],
"title": "Space",
"type": "string"
}
},
"required": [
"n",
"d",
"space"
],
"title": "Position",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"RevoiceOperation": {
"additionalProperties": false,
"properties": {
"op": {
"const": "revoice",
"title": "Op",
"type": "string"
},
"destinations": {
"items": {
"$ref": "#/$defs/NotePitchDestination"
},
"title": "Destinations",
"type": "array"
},
"hypothesis": {
"$ref": "#/$defs/HarmonicHypothesis"
},
"controller_timeline": {
"const": "preserve_existing",
"title": "Controller Timeline",
"type": "string"
},
"pitch_expression": {
"const": "preserve_relative",
"title": "Pitch Expression",
"type": "string"
}
},
"required": [
"op",
"destinations",
"hypothesis",
"controller_timeline",
"pitch_expression"
],
"title": "RevoiceOperation",
"type": "object"
},
"SplitOperation": {
"additionalProperties": false,
"properties": {
"op": {
"const": "split",
"title": "Op",
"type": "string"
},
"offsets_qn": {
"items": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
]
},
"title": "Offsets Qn",
"type": "array"
},
"controller_timeline": {
"const": "preserve_existing",
"title": "Controller Timeline",
"type": "string"
},
"time_space": {
"const": "note_relative_qn",
"title": "Time Space",
"type": "string"
},
"articulation": {
"const": "retrigger",
"title": "Articulation",
"type": "string"
}
},
"required": [
"op",
"offsets_qn",
"controller_timeline",
"time_space",
"articulation"
],
"title": "SplitOperation",
"type": "object"
},
"VelocityMapOperation": {
"additionalProperties": false,
"properties": {
"op": {
"const": "velocity_map",
"title": "Op",
"type": "string"
},
"field": {
"enum": [
"velocity",
"release_velocity"
],
"title": "Field",
"type": "string"
},
"mapping": {
"items": {
"$ref": "#/$defs/VelocityMappingEntry"
},
"title": "Mapping",
"type": "array"
},
"unmapped": {
"enum": [
"preserve",
"reject"
],
"title": "Unmapped",
"type": "string"
}
},
"required": [
"op",
"field",
"mapping",
"unmapped"
],
"title": "VelocityMapOperation",
"type": "object"
},
"VelocityMappingEntry": {
"additionalProperties": false,
"properties": {
"from_value": {
"title": "From Value",
"type": "integer"
},
"to_value": {
"title": "To Value",
"type": "integer"
}
},
"required": [
"from_value",
"to_value"
],
"title": "VelocityMappingEntry",
"type": "object"
},
"VelocityRecord": {
"additionalProperties": false,
"properties": {
"value": {
"title": "Value",
"type": "integer"
},
"domain": {
"const": "midi1_7bit",
"title": "Domain",
"type": "string"
}
},
"required": [
"value",
"domain"
],
"title": "VelocityRecord",
"type": "object"
},
"WireEvent": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"time": {
"$ref": "#/$defs/Position"
},
"order": {
"title": "Order",
"type": "integer"
},
"message_type": {
"title": "Message Type",
"type": "string"
},
"is_meta": {
"title": "Is Meta",
"type": "boolean"
},
"bytes": {
"items": {
"type": "integer"
},
"title": "Bytes",
"type": "array"
},
"source_tick": {
"title": "Source Tick",
"type": "integer"
},
"track_index": {
"title": "Track Index",
"type": "integer"
}
},
"required": [
"id",
"time",
"order",
"message_type",
"is_meta",
"bytes"
],
"title": "WireEvent",
"type": "object"
}
},
"properties": {
"material": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/MaterialRecord"
}
],
"title": "Material"
},
"selection": {
"$ref": "#/$defs/MaterialSelection"
},
"operations": {
"items": {
"anyOf": [
{
"$ref": "#/$defs/EditOperation"
},
{
"$ref": "#/$defs/DeleteOperation"
},
{
"$ref": "#/$defs/DuplicateOperation"
},
{
"$ref": "#/$defs/GridQuantizeOperation"
},
{
"$ref": "#/$defs/VelocityMapOperation"
},
{
"$ref": "#/$defs/AddOperation"
},
{
"$ref": "#/$defs/SplitOperation"
},
{
"$ref": "#/$defs/MergeOperation"
},
{
"$ref": "#/$defs/GrooveOperation"
},
{
"$ref": "#/$defs/RevoiceOperation"
}
]
},
"title": "Operations",
"type": "array"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"locks": {
"anyOf": [
{
"$ref": "#/$defs/MaterialLocks"
},
{
"type": "null"
}
],
"default": null
},
"expression_policy": {
"default": "reject",
"title": "Expression Policy",
"type": "string"
},
"overlap_policy": {
"default": "reject_new",
"title": "Overlap Policy",
"type": "string"
}
},
"required": [
"material",
"selection",
"operations",
"store_root",
"request_id"
],
"title": "midi_transformArguments",
"type": "object",
"additionalProperties": false
}midi_export SMF derivative with explicit fidelity, raw-event policy and optional exact CC1/CC11 steps.
Domain: midi. Read only: false.
Python
pocket_music.midi_io.midi_export(material: 'ArtifactHandle | MaterialRecord', store_root: 'str', output_path: 'str', request_id: 'str', format: 'str' = 'smf1', ppq: 'int | None' = None, loss_policy: 'str' = 'reject_unapproved', approved_losses: 'list[str] | None' = None, cc_step_bindings: 'list[CCStepBinding] | None' = None, expression: 'ExpressionConfiguration | ArtifactHandle | None' = None) -> 'dict'CLI
pocket midi-export --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ClipRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"$ref": "#/$defs/Rational"
},
"loop": {
"const": false,
"title": "Loop",
"type": "boolean"
},
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"event_ids": {
"items": {
"type": "string"
},
"title": "Event Ids",
"type": "array"
},
"curve_ids": {
"items": {
"type": "string"
},
"title": "Curve Ids",
"type": "array"
}
},
"required": [
"id",
"track_id",
"origin",
"length_qn",
"loop",
"note_ids",
"event_ids",
"curve_ids"
],
"title": "ClipRecord",
"type": "object"
},
"EmbeddedCCStepBinding": {
"additionalProperties": false,
"properties": {
"curve_id": {
"title": "Curve Id",
"type": "string"
},
"controller": {
"enum": [
1,
11
],
"title": "Controller",
"type": "integer"
},
"same_tick_order": {
"const": "before_existing",
"title": "Same Tick Order",
"type": "string"
}
},
"required": [
"curve_id",
"controller",
"same_tick_order"
],
"title": "EmbeddedCCStepBinding",
"type": "object"
},
"ExpressionAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"evidence": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Evidence",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"evidence"
],
"title": "ExpressionAttribution",
"type": "object"
},
"ExpressionConfiguration": {
"additionalProperties": false,
"properties": {
"lifecycle": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/ExpressionLifecycleRequest"
}
],
"title": "Lifecycle"
},
"receiver_assumption": {
"$ref": "#/$defs/ReceiverAssumption"
},
"encoding": {
"$ref": "#/$defs/ExpressionEncoding"
}
},
"required": [
"lifecycle",
"receiver_assumption",
"encoding"
],
"title": "ExpressionConfiguration",
"type": "object"
},
"ExpressionEncoding": {
"additionalProperties": false,
"properties": {
"source_channel_policy": {
"const": "single_source_channel_to_zone",
"title": "Source Channel Policy",
"type": "string"
},
"sustain_route": {
"const": "manager_cc64",
"title": "Sustain Route",
"type": "string"
},
"allocation": {
"const": "lowest_available_zone_order",
"title": "Allocation",
"type": "string"
},
"exhaustion": {
"const": "reject_no_stealing",
"title": "Exhaustion",
"type": "string"
},
"reservation": {
"const": "through_symbolic_release_plus_declared_tail",
"title": "Reservation",
"type": "string"
},
"same_pitch_policy": {
"const": "new_per_note_channel_realization",
"title": "Same Pitch Policy",
"type": "string"
},
"tuning": {
"const": "tuning:12tet-a440",
"title": "Tuning",
"type": "string"
},
"neutral": {
"$ref": "#/$defs/ExpressionNeutral"
},
"curve_mode": {
"const": "step_only",
"title": "Curve Mode",
"type": "string"
},
"rounding": {
"const": "nearest_ties_even",
"title": "Rounding",
"type": "string"
},
"max_pitch_error_cents": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Max Pitch Error Cents"
},
"max_control_error_normalized": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Max Control Error Normalized"
},
"reuse_order": {
"const": "old_expression_then_declared_off_cc_then_reset_setup_on",
"title": "Reuse Order",
"type": "string"
}
},
"required": [
"source_channel_policy",
"sustain_route",
"allocation",
"exhaustion",
"reservation",
"same_pitch_policy",
"tuning",
"neutral",
"curve_mode",
"rounding",
"max_pitch_error_cents",
"max_control_error_normalized",
"reuse_order"
],
"title": "ExpressionEncoding",
"type": "object"
},
"ExpressionLifecycleRequest": {
"additionalProperties": false,
"properties": {
"clip_id": {
"title": "Clip Id",
"type": "string"
},
"initial_state": {
"$ref": "#/$defs/LifecycleInitialState"
},
"horizon_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Horizon Qn"
},
"release_tail_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Release Tail Qn"
},
"equal_time_order": {
"enum": [
"note_off_cc_note_on",
"cc_note_off_note_on"
],
"title": "Equal Time Order",
"type": "string"
},
"source_basis": {
"const": "canonical_notes_retained_cc64",
"title": "Source Basis",
"type": "string"
}
},
"required": [
"clip_id",
"initial_state",
"horizon_qn",
"release_tail_qn",
"equal_time_order",
"source_basis"
],
"title": "ExpressionLifecycleRequest",
"type": "object"
},
"ExpressionNeutral": {
"additionalProperties": false,
"properties": {
"pitch_cents": {
"const": 0,
"title": "Pitch Cents",
"type": "integer"
},
"pressure_7bit": {
"title": "Pressure 7Bit",
"type": "integer"
},
"slide_7bit": {
"title": "Slide 7Bit",
"type": "integer"
}
},
"required": [
"pitch_cents",
"pressure_7bit",
"slide_7bit"
],
"title": "ExpressionNeutral",
"type": "object"
},
"ExternalCCStepBinding": {
"additionalProperties": false,
"properties": {
"curve": {
"$ref": "#/$defs/ArtifactHandle"
},
"clip_id": {
"title": "Clip Id",
"type": "string"
},
"controller": {
"enum": [
1,
11
],
"title": "Controller",
"type": "integer"
},
"same_tick_order": {
"const": "before_existing",
"title": "Same Tick Order",
"type": "string"
}
},
"required": [
"curve",
"clip_id",
"controller",
"same_tick_order"
],
"title": "ExternalCCStepBinding",
"type": "object"
},
"InitialSustain": {
"additionalProperties": false,
"properties": {
"channel": {
"title": "Channel",
"type": "integer"
},
"value": {
"title": "Value",
"type": "integer"
}
},
"required": [
"channel",
"value"
],
"title": "InitialSustain",
"type": "object"
},
"LifecycleInitialState": {
"additionalProperties": false,
"properties": {
"active_notes": {
"const": "none",
"title": "Active Notes",
"type": "string"
},
"sustain": {
"items": {
"$ref": "#/$defs/InitialSustain"
},
"title": "Sustain",
"type": "array"
}
},
"required": [
"active_notes",
"sustain"
],
"title": "LifecycleInitialState",
"type": "object"
},
"MaterialRecord": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.material/v1",
"title": "Schema",
"type": "string"
},
"material_id": {
"title": "Material Id",
"type": "string"
},
"revision_sha256": {
"title": "Revision Sha256",
"type": "string"
},
"parent_revision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Revision"
},
"sources": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Sources",
"type": "array"
},
"tracks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Tracks",
"type": "array"
},
"clips": {
"items": {
"$ref": "#/$defs/ClipRecord"
},
"title": "Clips",
"type": "array"
},
"notes": {
"items": {
"$ref": "#/$defs/NoteRecord"
},
"title": "Notes",
"type": "array"
},
"events": {
"items": {
"$ref": "#/$defs/WireEvent"
},
"title": "Events",
"type": "array"
},
"curves": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Curves",
"type": "array"
},
"tempo_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"meter_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"coverage": {
"additionalProperties": true,
"title": "Coverage",
"type": "object"
},
"provenance": {
"additionalProperties": true,
"title": "Provenance",
"type": "object"
}
},
"required": [
"schema",
"material_id",
"revision_sha256",
"parent_revision",
"sources",
"tracks",
"clips",
"notes",
"events",
"curves",
"tempo_map_ref",
"meter_map_ref",
"coverage",
"provenance"
],
"title": "MaterialRecord",
"type": "object"
},
"NoteRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"voice_id": {
"title": "Voice Id",
"type": "string"
},
"role_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Role Ref"
},
"onset": {
"$ref": "#/$defs/Position"
},
"duration_qn": {
"$ref": "#/$defs/Rational"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
},
"velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"release_velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"mute": {
"title": "Mute",
"type": "boolean"
},
"expression_refs": {
"items": {
"type": "string"
},
"title": "Expression Refs",
"type": "array"
},
"source_binding": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Source Binding"
},
"derived_from": {
"items": {
"type": "string"
},
"title": "Derived From",
"type": "array"
}
},
"required": [
"id",
"voice_id",
"role_ref",
"onset",
"duration_qn",
"pitch",
"velocity",
"release_velocity",
"channel",
"mute",
"expression_refs",
"source_binding",
"derived_from"
],
"title": "NoteRecord",
"type": "object"
},
"PitchRecord": {
"additionalProperties": false,
"properties": {
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
}
],
"title": "Cents Offset"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"midi_note",
"cents_offset",
"tuning_ref"
],
"title": "PitchRecord",
"type": "object"
},
"Position": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
},
"space": {
"enum": [
"clip_qn",
"phrase_qn",
"arrangement_qn"
],
"title": "Space",
"type": "string"
}
},
"required": [
"n",
"d",
"space"
],
"title": "Position",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"ReceiverAssumption": {
"additionalProperties": false,
"properties": {
"label": {
"title": "Label",
"type": "string"
},
"zone": {
"enum": [
"lower",
"upper"
],
"title": "Zone",
"type": "string"
},
"manager_channel": {
"title": "Manager Channel",
"type": "integer"
},
"member_channels": {
"items": {
"type": "integer"
},
"title": "Member Channels",
"type": "array"
},
"member_bend_range_semitones": {
"title": "Member Bend Range Semitones",
"type": "integer"
},
"manager_pitch_policy": {
"const": "neutral_no_pitch_messages",
"title": "Manager Pitch Policy",
"type": "string"
},
"configuration_policy": {
"const": "assume_preconfigured_no_setup_messages",
"title": "Configuration Policy",
"type": "string"
},
"configuration_status": {
"const": "declared_unverified",
"title": "Configuration Status",
"type": "string"
},
"attribution": {
"$ref": "#/$defs/ExpressionAttribution"
},
"instrument_state": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
}
},
"required": [
"label",
"zone",
"manager_channel",
"member_channels",
"member_bend_range_semitones",
"manager_pitch_policy",
"configuration_policy",
"configuration_status",
"attribution",
"instrument_state"
],
"title": "ReceiverAssumption",
"type": "object"
},
"VelocityRecord": {
"additionalProperties": false,
"properties": {
"value": {
"title": "Value",
"type": "integer"
},
"domain": {
"const": "midi1_7bit",
"title": "Domain",
"type": "string"
}
},
"required": [
"value",
"domain"
],
"title": "VelocityRecord",
"type": "object"
},
"WireEvent": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"time": {
"$ref": "#/$defs/Position"
},
"order": {
"title": "Order",
"type": "integer"
},
"message_type": {
"title": "Message Type",
"type": "string"
},
"is_meta": {
"title": "Is Meta",
"type": "boolean"
},
"bytes": {
"items": {
"type": "integer"
},
"title": "Bytes",
"type": "array"
},
"source_tick": {
"title": "Source Tick",
"type": "integer"
},
"track_index": {
"title": "Track Index",
"type": "integer"
}
},
"required": [
"id",
"time",
"order",
"message_type",
"is_meta",
"bytes"
],
"title": "WireEvent",
"type": "object"
}
},
"properties": {
"material": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/MaterialRecord"
}
],
"title": "Material"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"output_path": {
"title": "Output Path",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"format": {
"default": "smf1",
"title": "Format",
"type": "string"
},
"ppq": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Ppq"
},
"loss_policy": {
"default": "reject_unapproved",
"title": "Loss Policy",
"type": "string"
},
"approved_losses": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Approved Losses"
},
"cc_step_bindings": {
"anyOf": [
{
"items": {
"anyOf": [
{
"$ref": "#/$defs/EmbeddedCCStepBinding"
},
{
"$ref": "#/$defs/ExternalCCStepBinding"
}
]
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Cc Step Bindings"
},
"expression": {
"anyOf": [
{
"$ref": "#/$defs/ExpressionConfiguration"
},
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null,
"title": "Expression"
}
},
"required": [
"material",
"store_root",
"output_path",
"request_id"
],
"title": "midi_exportArguments",
"type": "object",
"additionalProperties": false
}midi_expression_plan Declared member-channel allocation and exact expression bytes; receiver setup remains unverified.
Domain: expression. Read only: false.
Python
pocket_music.midi_expression.midi_expression_plan(material: 'ArtifactHandle | MaterialRecord', lifecycle: 'ArtifactHandle | ExpressionLifecycleRequest', receiver_assumption: 'ReceiverAssumption', encoding: 'ExpressionEncoding', store_root: 'str', request_id: 'str') -> 'dict'CLI
pocket midi-expression-plan --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ClipRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"origin": {
"$ref": "#/$defs/Position"
},
"length_qn": {
"$ref": "#/$defs/Rational"
},
"loop": {
"const": false,
"title": "Loop",
"type": "boolean"
},
"note_ids": {
"items": {
"type": "string"
},
"title": "Note Ids",
"type": "array"
},
"event_ids": {
"items": {
"type": "string"
},
"title": "Event Ids",
"type": "array"
},
"curve_ids": {
"items": {
"type": "string"
},
"title": "Curve Ids",
"type": "array"
}
},
"required": [
"id",
"track_id",
"origin",
"length_qn",
"loop",
"note_ids",
"event_ids",
"curve_ids"
],
"title": "ClipRecord",
"type": "object"
},
"ExpressionAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"evidence": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Evidence",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"evidence"
],
"title": "ExpressionAttribution",
"type": "object"
},
"ExpressionEncoding": {
"additionalProperties": false,
"properties": {
"source_channel_policy": {
"const": "single_source_channel_to_zone",
"title": "Source Channel Policy",
"type": "string"
},
"sustain_route": {
"const": "manager_cc64",
"title": "Sustain Route",
"type": "string"
},
"allocation": {
"const": "lowest_available_zone_order",
"title": "Allocation",
"type": "string"
},
"exhaustion": {
"const": "reject_no_stealing",
"title": "Exhaustion",
"type": "string"
},
"reservation": {
"const": "through_symbolic_release_plus_declared_tail",
"title": "Reservation",
"type": "string"
},
"same_pitch_policy": {
"const": "new_per_note_channel_realization",
"title": "Same Pitch Policy",
"type": "string"
},
"tuning": {
"const": "tuning:12tet-a440",
"title": "Tuning",
"type": "string"
},
"neutral": {
"$ref": "#/$defs/ExpressionNeutral"
},
"curve_mode": {
"const": "step_only",
"title": "Curve Mode",
"type": "string"
},
"rounding": {
"const": "nearest_ties_even",
"title": "Rounding",
"type": "string"
},
"max_pitch_error_cents": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Max Pitch Error Cents"
},
"max_control_error_normalized": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Max Control Error Normalized"
},
"reuse_order": {
"const": "old_expression_then_declared_off_cc_then_reset_setup_on",
"title": "Reuse Order",
"type": "string"
}
},
"required": [
"source_channel_policy",
"sustain_route",
"allocation",
"exhaustion",
"reservation",
"same_pitch_policy",
"tuning",
"neutral",
"curve_mode",
"rounding",
"max_pitch_error_cents",
"max_control_error_normalized",
"reuse_order"
],
"title": "ExpressionEncoding",
"type": "object"
},
"ExpressionLifecycleRequest": {
"additionalProperties": false,
"properties": {
"clip_id": {
"title": "Clip Id",
"type": "string"
},
"initial_state": {
"$ref": "#/$defs/LifecycleInitialState"
},
"horizon_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Horizon Qn"
},
"release_tail_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Release Tail Qn"
},
"equal_time_order": {
"enum": [
"note_off_cc_note_on",
"cc_note_off_note_on"
],
"title": "Equal Time Order",
"type": "string"
},
"source_basis": {
"const": "canonical_notes_retained_cc64",
"title": "Source Basis",
"type": "string"
}
},
"required": [
"clip_id",
"initial_state",
"horizon_qn",
"release_tail_qn",
"equal_time_order",
"source_basis"
],
"title": "ExpressionLifecycleRequest",
"type": "object"
},
"ExpressionNeutral": {
"additionalProperties": false,
"properties": {
"pitch_cents": {
"const": 0,
"title": "Pitch Cents",
"type": "integer"
},
"pressure_7bit": {
"title": "Pressure 7Bit",
"type": "integer"
},
"slide_7bit": {
"title": "Slide 7Bit",
"type": "integer"
}
},
"required": [
"pitch_cents",
"pressure_7bit",
"slide_7bit"
],
"title": "ExpressionNeutral",
"type": "object"
},
"InitialSustain": {
"additionalProperties": false,
"properties": {
"channel": {
"title": "Channel",
"type": "integer"
},
"value": {
"title": "Value",
"type": "integer"
}
},
"required": [
"channel",
"value"
],
"title": "InitialSustain",
"type": "object"
},
"LifecycleInitialState": {
"additionalProperties": false,
"properties": {
"active_notes": {
"const": "none",
"title": "Active Notes",
"type": "string"
},
"sustain": {
"items": {
"$ref": "#/$defs/InitialSustain"
},
"title": "Sustain",
"type": "array"
}
},
"required": [
"active_notes",
"sustain"
],
"title": "LifecycleInitialState",
"type": "object"
},
"MaterialRecord": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.material/v1",
"title": "Schema",
"type": "string"
},
"material_id": {
"title": "Material Id",
"type": "string"
},
"revision_sha256": {
"title": "Revision Sha256",
"type": "string"
},
"parent_revision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Revision"
},
"sources": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Sources",
"type": "array"
},
"tracks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Tracks",
"type": "array"
},
"clips": {
"items": {
"$ref": "#/$defs/ClipRecord"
},
"title": "Clips",
"type": "array"
},
"notes": {
"items": {
"$ref": "#/$defs/NoteRecord"
},
"title": "Notes",
"type": "array"
},
"events": {
"items": {
"$ref": "#/$defs/WireEvent"
},
"title": "Events",
"type": "array"
},
"curves": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Curves",
"type": "array"
},
"tempo_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"meter_map_ref": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"coverage": {
"additionalProperties": true,
"title": "Coverage",
"type": "object"
},
"provenance": {
"additionalProperties": true,
"title": "Provenance",
"type": "object"
}
},
"required": [
"schema",
"material_id",
"revision_sha256",
"parent_revision",
"sources",
"tracks",
"clips",
"notes",
"events",
"curves",
"tempo_map_ref",
"meter_map_ref",
"coverage",
"provenance"
],
"title": "MaterialRecord",
"type": "object"
},
"NoteRecord": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"voice_id": {
"title": "Voice Id",
"type": "string"
},
"role_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Role Ref"
},
"onset": {
"$ref": "#/$defs/Position"
},
"duration_qn": {
"$ref": "#/$defs/Rational"
},
"pitch": {
"$ref": "#/$defs/PitchRecord"
},
"velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"release_velocity": {
"$ref": "#/$defs/VelocityRecord"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"mute": {
"title": "Mute",
"type": "boolean"
},
"expression_refs": {
"items": {
"type": "string"
},
"title": "Expression Refs",
"type": "array"
},
"source_binding": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Source Binding"
},
"derived_from": {
"items": {
"type": "string"
},
"title": "Derived From",
"type": "array"
}
},
"required": [
"id",
"voice_id",
"role_ref",
"onset",
"duration_qn",
"pitch",
"velocity",
"release_velocity",
"channel",
"mute",
"expression_refs",
"source_binding",
"derived_from"
],
"title": "NoteRecord",
"type": "object"
},
"PitchRecord": {
"additionalProperties": false,
"properties": {
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
}
],
"title": "Cents Offset"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"midi_note",
"cents_offset",
"tuning_ref"
],
"title": "PitchRecord",
"type": "object"
},
"Position": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
},
"space": {
"enum": [
"clip_qn",
"phrase_qn",
"arrangement_qn"
],
"title": "Space",
"type": "string"
}
},
"required": [
"n",
"d",
"space"
],
"title": "Position",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"ReceiverAssumption": {
"additionalProperties": false,
"properties": {
"label": {
"title": "Label",
"type": "string"
},
"zone": {
"enum": [
"lower",
"upper"
],
"title": "Zone",
"type": "string"
},
"manager_channel": {
"title": "Manager Channel",
"type": "integer"
},
"member_channels": {
"items": {
"type": "integer"
},
"title": "Member Channels",
"type": "array"
},
"member_bend_range_semitones": {
"title": "Member Bend Range Semitones",
"type": "integer"
},
"manager_pitch_policy": {
"const": "neutral_no_pitch_messages",
"title": "Manager Pitch Policy",
"type": "string"
},
"configuration_policy": {
"const": "assume_preconfigured_no_setup_messages",
"title": "Configuration Policy",
"type": "string"
},
"configuration_status": {
"const": "declared_unverified",
"title": "Configuration Status",
"type": "string"
},
"attribution": {
"$ref": "#/$defs/ExpressionAttribution"
},
"instrument_state": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
}
},
"required": [
"label",
"zone",
"manager_channel",
"member_channels",
"member_bend_range_semitones",
"manager_pitch_policy",
"configuration_policy",
"configuration_status",
"attribution",
"instrument_state"
],
"title": "ReceiverAssumption",
"type": "object"
},
"VelocityRecord": {
"additionalProperties": false,
"properties": {
"value": {
"title": "Value",
"type": "integer"
},
"domain": {
"const": "midi1_7bit",
"title": "Domain",
"type": "string"
}
},
"required": [
"value",
"domain"
],
"title": "VelocityRecord",
"type": "object"
},
"WireEvent": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"time": {
"$ref": "#/$defs/Position"
},
"order": {
"title": "Order",
"type": "integer"
},
"message_type": {
"title": "Message Type",
"type": "string"
},
"is_meta": {
"title": "Is Meta",
"type": "boolean"
},
"bytes": {
"items": {
"type": "integer"
},
"title": "Bytes",
"type": "array"
},
"source_tick": {
"title": "Source Tick",
"type": "integer"
},
"track_index": {
"title": "Track Index",
"type": "integer"
}
},
"required": [
"id",
"time",
"order",
"message_type",
"is_meta",
"bytes"
],
"title": "WireEvent",
"type": "object"
}
},
"properties": {
"material": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/MaterialRecord"
}
],
"title": "Material"
},
"lifecycle": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/ExpressionLifecycleRequest"
}
],
"title": "Lifecycle"
},
"receiver_assumption": {
"$ref": "#/$defs/ReceiverAssumption"
},
"encoding": {
"$ref": "#/$defs/ExpressionEncoding"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"material",
"lifecycle",
"receiver_assumption",
"encoding",
"store_root",
"request_id"
],
"title": "midi_expression_planArguments",
"type": "object",
"additionalProperties": false
}audio_hypotheses Retain exact local source frames and competing deterministic Peek evidence without transcription.
Domain: audio. Read only: false.
Python
pocket_music.audio_hypotheses.audio_hypotheses(*, store_root: 'str', request_id: 'str', source: 'AudioHypothesisSource', settings: 'AudioHypothesisSettings', attribution: 'AudioHypothesisAttribution') -> 'dict'CLI
pocket audio-hypotheses --spec <arguments.json>MCP input schema
{
"$defs": {
"AudioHypothesisAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "AudioHypothesisAttribution",
"type": "object"
},
"AudioHypothesisSettings": {
"additionalProperties": false,
"properties": {
"bpm_hint": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Bpm Hint"
},
"beats_per_bar": {
"title": "Beats Per Bar",
"type": "integer"
}
},
"required": [
"bpm_hint",
"beats_per_bar"
],
"title": "AudioHypothesisSettings",
"type": "object"
},
"AudioHypothesisSource": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"frames": {
"title": "Frames",
"type": "integer"
},
"source_origin": {
"enum": [
"independently_acquired",
"user_recording"
],
"title": "Source Origin",
"type": "string"
}
},
"required": [
"path",
"expected_sha256",
"start_frame",
"frames",
"source_origin"
],
"title": "AudioHypothesisSource",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"source": {
"$ref": "#/$defs/AudioHypothesisSource"
},
"settings": {
"$ref": "#/$defs/AudioHypothesisSettings"
},
"attribution": {
"$ref": "#/$defs/AudioHypothesisAttribution"
}
},
"required": [
"store_root",
"request_id",
"source",
"settings",
"attribution"
],
"title": "audio_hypothesesArguments",
"type": "object",
"additionalProperties": false
}audio_region_capture Stream-verify a declared long PCM source and retain exact bounded crop bytes with original-frame mapping.
Domain: audio. Read only: false.
Python
pocket_music.audio_regions.audio_region_capture(*, store_root: 'str', request_id: 'str', source: 'AudioRegionSource') -> 'dict'CLI
pocket audio-region-capture --spec <arguments.json>MCP input schema
{
"$defs": {
"AudioRegionSource": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"frames": {
"title": "Frames",
"type": "integer"
},
"source_origin": {
"enum": [
"independently_acquired",
"user_recording"
],
"title": "Source Origin",
"type": "string"
}
},
"required": [
"path",
"expected_sha256",
"start_frame",
"frames",
"source_origin"
],
"title": "AudioRegionSource",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"source": {
"$ref": "#/$defs/AudioRegionSource"
}
},
"required": [
"store_root",
"request_id",
"source"
],
"title": "audio_region_captureArguments",
"type": "object",
"additionalProperties": false
}audio_region_hypotheses Compose explicit region capture and public analysis, retaining local evidence and exact original-frame mapping.
Domain: audio. Read only: false.
Python
pocket_music.audio_region_analysis.audio_region_hypotheses(*, store_root: 'str', request_id: 'str', region: 'AudioRegionInput', analysis: 'AudioRegionAnalysis', attribution: 'AudioHypothesisAttribution') -> 'dict'CLI
pocket audio-region-hypotheses --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"AudioHypothesisAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "AudioHypothesisAttribution",
"type": "object"
},
"AudioHypothesisSettings": {
"additionalProperties": false,
"properties": {
"bpm_hint": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Bpm Hint"
},
"beats_per_bar": {
"title": "Beats Per Bar",
"type": "integer"
}
},
"required": [
"bpm_hint",
"beats_per_bar"
],
"title": "AudioHypothesisSettings",
"type": "object"
},
"AudioModelDeclaration": {
"additionalProperties": false,
"properties": {
"adapter": {
"const": "beat_this_cpu_v1",
"title": "Adapter",
"type": "string"
},
"executable": {
"$ref": "#/$defs/AudioModelFile"
},
"weights": {
"$ref": "#/$defs/AudioModelFile"
},
"expected_profile": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Expected Profile"
}
},
"required": [
"adapter",
"executable",
"weights",
"expected_profile"
],
"title": "AudioModelDeclaration",
"type": "object"
},
"AudioModelFile": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
}
},
"required": [
"path",
"sha256"
],
"title": "AudioModelFile",
"type": "object"
},
"AudioNoteModelDeclaration": {
"additionalProperties": false,
"properties": {
"adapter": {
"const": "basic_pitch_onnx_cpu_v1",
"title": "Adapter",
"type": "string"
},
"executable": {
"$ref": "#/$defs/AudioModelFile"
},
"weights": {
"$ref": "#/$defs/AudioModelFile"
},
"expected_profile": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Expected Profile"
}
},
"required": [
"adapter",
"executable",
"weights",
"expected_profile"
],
"title": "AudioNoteModelDeclaration",
"type": "object"
},
"AudioNoteSettings": {
"additionalProperties": false,
"properties": {
"device": {
"const": "cpu",
"title": "Device",
"type": "string"
},
"dtype": {
"const": "float32",
"title": "Dtype",
"type": "string"
},
"threads": {
"const": 1,
"title": "Threads",
"type": "integer"
},
"downmix": {
"const": "arithmetic_mean",
"title": "Downmix",
"type": "string"
},
"resampler": {
"const": "soxr_hq",
"title": "Resampler",
"type": "string"
},
"decoder": {
"enum": [
"basic_pitch_0_4_0_false_false_v1",
"basic_pitch_0_4_0_false_false_v2"
],
"title": "Decoder",
"type": "string"
},
"onset_threshold": {
"const": 0.5,
"title": "Onset Threshold",
"type": "number"
},
"frame_threshold": {
"const": 0.3,
"title": "Frame Threshold",
"type": "number"
},
"min_note_frames": {
"const": 11,
"title": "Min Note Frames",
"type": "integer"
},
"energy_tol": {
"const": 11,
"title": "Energy Tol",
"type": "integer"
},
"infer_onsets": {
"const": false,
"title": "Infer Onsets",
"type": "boolean"
},
"melodia_trick": {
"const": false,
"title": "Melodia Trick",
"type": "boolean"
}
},
"required": [
"device",
"dtype",
"threads",
"downmix",
"resampler",
"decoder",
"onset_threshold",
"frame_threshold",
"min_note_frames",
"energy_tol",
"infer_onsets",
"melodia_trick"
],
"title": "AudioNoteSettings",
"type": "object"
},
"AudioPulseSettings": {
"additionalProperties": false,
"properties": {
"device": {
"const": "cpu",
"title": "Device",
"type": "string"
},
"dtype": {
"const": "float32",
"title": "Dtype",
"type": "string"
},
"threads": {
"const": 1,
"title": "Threads",
"type": "integer"
},
"postprocessor": {
"const": "minimal",
"title": "Postprocessor",
"type": "string"
},
"downmix": {
"const": "arithmetic_mean",
"title": "Downmix",
"type": "string"
},
"resampler": {
"const": "soxr_hq",
"title": "Resampler",
"type": "string"
},
"seed": {
"const": 0,
"title": "Seed",
"type": "integer"
}
},
"required": [
"device",
"dtype",
"threads",
"postprocessor",
"downmix",
"resampler",
"seed"
],
"title": "AudioPulseSettings",
"type": "object"
},
"AudioRegionSource": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"frames": {
"title": "Frames",
"type": "integer"
},
"source_origin": {
"enum": [
"independently_acquired",
"user_recording"
],
"title": "Source Origin",
"type": "string"
}
},
"required": [
"path",
"expected_sha256",
"start_frame",
"frames",
"source_origin"
],
"title": "AudioRegionSource",
"type": "object"
},
"CapturedAudioRegion": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "captured",
"title": "Kind",
"type": "string"
},
"region": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"kind",
"region"
],
"title": "CapturedAudioRegion",
"type": "object"
},
"InlineAudioNoteModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inline",
"title": "Kind",
"type": "string"
},
"declaration": {
"$ref": "#/$defs/AudioNoteModelDeclaration"
},
"qualification": {
"const": "synthetic_onnx_cpu_v1",
"title": "Qualification",
"type": "string"
}
},
"required": [
"kind",
"declaration",
"qualification"
],
"title": "InlineAudioNoteModel",
"type": "object"
},
"InlineAudioPulseModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inline",
"title": "Kind",
"type": "string"
},
"declaration": {
"$ref": "#/$defs/AudioModelDeclaration"
},
"qualification": {
"const": "synthetic_cpu_v1",
"title": "Qualification",
"type": "string"
}
},
"required": [
"kind",
"declaration",
"qualification"
],
"title": "InlineAudioPulseModel",
"type": "object"
},
"InlineAudioRegion": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inline",
"title": "Kind",
"type": "string"
},
"source": {
"$ref": "#/$defs/AudioRegionSource"
}
},
"required": [
"kind",
"source"
],
"title": "InlineAudioRegion",
"type": "object"
},
"InspectedAudioNoteModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inspected",
"title": "Kind",
"type": "string"
},
"model": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"kind",
"model"
],
"title": "InspectedAudioNoteModel",
"type": "object"
},
"InspectedAudioPulseModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inspected",
"title": "Kind",
"type": "string"
},
"model": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"kind",
"model"
],
"title": "InspectedAudioPulseModel",
"type": "object"
},
"LearnedNoteRegionAnalysis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "learned_notes",
"title": "Kind",
"type": "string"
},
"model": {
"anyOf": [
{
"$ref": "#/$defs/InlineAudioNoteModel"
},
{
"$ref": "#/$defs/InspectedAudioNoteModel"
}
],
"title": "Model"
},
"settings": {
"$ref": "#/$defs/AudioNoteSettings"
}
},
"required": [
"kind",
"model",
"settings"
],
"title": "LearnedNoteRegionAnalysis",
"type": "object"
},
"LearnedPulseRegionAnalysis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "learned_pulse",
"title": "Kind",
"type": "string"
},
"model": {
"anyOf": [
{
"$ref": "#/$defs/InlineAudioPulseModel"
},
{
"$ref": "#/$defs/InspectedAudioPulseModel"
}
],
"title": "Model"
},
"settings": {
"$ref": "#/$defs/AudioPulseSettings"
}
},
"required": [
"kind",
"model",
"settings"
],
"title": "LearnedPulseRegionAnalysis",
"type": "object"
},
"PeekRegionAnalysis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "peek",
"title": "Kind",
"type": "string"
},
"settings": {
"$ref": "#/$defs/AudioHypothesisSettings"
}
},
"required": [
"kind",
"settings"
],
"title": "PeekRegionAnalysis",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"region": {
"anyOf": [
{
"$ref": "#/$defs/InlineAudioRegion"
},
{
"$ref": "#/$defs/CapturedAudioRegion"
}
],
"title": "Region"
},
"analysis": {
"anyOf": [
{
"$ref": "#/$defs/PeekRegionAnalysis"
},
{
"$ref": "#/$defs/LearnedPulseRegionAnalysis"
},
{
"$ref": "#/$defs/LearnedNoteRegionAnalysis"
}
],
"title": "Analysis"
},
"attribution": {
"$ref": "#/$defs/AudioHypothesisAttribution"
}
},
"required": [
"store_root",
"request_id",
"region",
"analysis",
"attribution"
],
"title": "audio_region_hypothesesArguments",
"type": "object",
"additionalProperties": false
}audio_region_query Read bounded local hypotheses and original-frame projections without reanalysis or an optional model runtime.
Domain: audio. Read only: true.
Python
pocket_music.audio_region_analysis.audio_region_query(*, store_root: 'str', hypotheses: 'ArtifactHandle', view: "Literal['summary', 'annotations']" = 'summary', limit: 'int' = 32, cursor: 'str | None' = None, max_bytes: 'int' = 16384) -> 'dict'CLI
pocket audio-region-query --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"hypotheses": {
"$ref": "#/$defs/ArtifactHandle"
},
"view": {
"default": "summary",
"enum": [
"summary",
"annotations"
],
"title": "View",
"type": "string"
},
"limit": {
"default": 32,
"title": "Limit",
"type": "integer"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cursor"
},
"max_bytes": {
"default": 16384,
"title": "Max Bytes",
"type": "integer"
}
},
"required": [
"store_root",
"hypotheses"
],
"title": "audio_region_queryArguments",
"type": "object",
"additionalProperties": false
}audio_region_correct Compose attributed corrections in explicitly declared crop-local or original-recording coordinates, preserving raw evidence.
Domain: audio. Read only: false.
Python
pocket_music.audio_region_corrections.audio_region_correct(*, store_root: 'str', request_id: 'str', parent: 'ArtifactHandle', expected_revision: 'str', batch: 'AudioRegionCorrectionBatch', attribution: 'AudioHypothesisAttribution') -> 'dict'CLI
pocket audio-region-correct --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"AttackHypothesis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "attack",
"title": "Kind",
"type": "string"
},
"source_frame": {
"title": "Source Frame",
"type": "integer"
},
"strength_relative": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Strength Relative"
}
},
"required": [
"kind",
"source_frame",
"strength_relative"
],
"title": "AttackHypothesis",
"type": "object"
},
"AudioEvidenceSupport": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"analysis_pointer",
"annotation_id"
],
"title": "Kind",
"type": "string"
},
"reference": {
"title": "Reference",
"type": "string"
}
},
"required": [
"kind",
"reference"
],
"title": "AudioEvidenceSupport",
"type": "object"
},
"AudioHypothesisAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "AudioHypothesisAttribution",
"type": "object"
},
"AudioHypothesisCorrection": {
"additionalProperties": false,
"properties": {
"correction_id": {
"title": "Correction Id",
"type": "string"
},
"supersedes": {
"items": {
"type": "string"
},
"title": "Supersedes",
"type": "array"
},
"annotation": {
"anyOf": [
{
"$ref": "#/$defs/AttackHypothesis"
},
{
"$ref": "#/$defs/PulseHypothesis"
},
{
"$ref": "#/$defs/PhraseAnchorHypothesis"
},
{
"$ref": "#/$defs/NoteHypothesis"
}
],
"title": "Annotation"
},
"support": {
"items": {
"$ref": "#/$defs/AudioEvidenceSupport"
},
"title": "Support",
"type": "array"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"correction_id",
"supersedes",
"annotation",
"support",
"uncertainty"
],
"title": "AudioHypothesisCorrection",
"type": "object"
},
"LocalRegionCorrections": {
"additionalProperties": false,
"properties": {
"coordinate_space": {
"const": "local_crop_frame",
"title": "Coordinate Space",
"type": "string"
},
"corrections": {
"items": {
"$ref": "#/$defs/AudioHypothesisCorrection"
},
"title": "Corrections",
"type": "array"
}
},
"required": [
"coordinate_space",
"corrections"
],
"title": "LocalRegionCorrections",
"type": "object"
},
"NoteHypothesis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "note_hypothesis",
"title": "Kind",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"end_frame_exclusive": {
"title": "End Frame Exclusive",
"type": "integer"
},
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
}
],
"title": "Cents"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"kind",
"start_frame",
"end_frame_exclusive",
"midi_note",
"cents",
"tuning_ref"
],
"title": "NoteHypothesis",
"type": "object"
},
"OriginalPulseHypothesis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "pulse_candidate",
"title": "Kind",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"end_frame_exclusive": {
"title": "End Frame Exclusive",
"type": "integer"
},
"bpm": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
}
],
"title": "Bpm"
},
"lattice_origin": {
"$ref": "#/$defs/OriginalPulseLatticeOrigin"
}
},
"required": [
"kind",
"start_frame",
"end_frame_exclusive",
"bpm",
"lattice_origin"
],
"title": "OriginalPulseHypothesis",
"type": "object"
},
"OriginalPulseLatticeOrigin": {
"additionalProperties": false,
"properties": {
"local_estimate_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
}
],
"title": "Local Estimate Seconds"
},
"original_offset_seconds_q": {
"$ref": "#/$defs/Rational"
}
},
"required": [
"local_estimate_seconds",
"original_offset_seconds_q"
],
"title": "OriginalPulseLatticeOrigin",
"type": "object"
},
"OriginalRegionCorrection": {
"additionalProperties": false,
"properties": {
"correction_id": {
"title": "Correction Id",
"type": "string"
},
"supersedes": {
"items": {
"type": "string"
},
"title": "Supersedes",
"type": "array"
},
"annotation": {
"anyOf": [
{
"$ref": "#/$defs/AttackHypothesis"
},
{
"$ref": "#/$defs/OriginalPulseHypothesis"
},
{
"$ref": "#/$defs/PhraseAnchorHypothesis"
},
{
"$ref": "#/$defs/NoteHypothesis"
}
],
"title": "Annotation"
},
"support": {
"items": {
"$ref": "#/$defs/AudioEvidenceSupport"
},
"title": "Support",
"type": "array"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"correction_id",
"supersedes",
"annotation",
"support",
"uncertainty"
],
"title": "OriginalRegionCorrection",
"type": "object"
},
"OriginalRegionCorrections": {
"additionalProperties": false,
"properties": {
"coordinate_space": {
"const": "original_source_frame",
"title": "Coordinate Space",
"type": "string"
},
"corrections": {
"items": {
"$ref": "#/$defs/OriginalRegionCorrection"
},
"title": "Corrections",
"type": "array"
}
},
"required": [
"coordinate_space",
"corrections"
],
"title": "OriginalRegionCorrections",
"type": "object"
},
"PhraseAnchorHypothesis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "phrase_anchor",
"title": "Kind",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"end_frame_exclusive": {
"title": "End Frame Exclusive",
"type": "integer"
},
"label": {
"title": "Label",
"type": "string"
}
},
"required": [
"kind",
"start_frame",
"end_frame_exclusive",
"label"
],
"title": "PhraseAnchorHypothesis",
"type": "object"
},
"PulseHypothesis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "pulse_candidate",
"title": "Kind",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"end_frame_exclusive": {
"title": "End Frame Exclusive",
"type": "integer"
},
"bpm": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
}
],
"title": "Bpm"
},
"source_lattice_origin_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
}
],
"title": "Source Lattice Origin Seconds"
}
},
"required": [
"kind",
"start_frame",
"end_frame_exclusive",
"bpm",
"source_lattice_origin_seconds"
],
"title": "PulseHypothesis",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"parent": {
"$ref": "#/$defs/ArtifactHandle"
},
"expected_revision": {
"title": "Expected Revision",
"type": "string"
},
"batch": {
"anyOf": [
{
"$ref": "#/$defs/LocalRegionCorrections"
},
{
"$ref": "#/$defs/OriginalRegionCorrections"
}
],
"title": "Batch"
},
"attribution": {
"$ref": "#/$defs/AudioHypothesisAttribution"
}
},
"required": [
"store_root",
"request_id",
"parent",
"expected_revision",
"batch",
"attribution"
],
"title": "audio_region_correctArguments",
"type": "object",
"additionalProperties": false
}audio_region_submit Establish durable worker ownership before long-source capture and run the same public mapped analysis.
Domain: audio. Read only: false.
Python
pocket_music.audio_hypothesis_jobs.audio_region_submit(*, store_root: 'str', request_id: 'str', region: 'AudioRegionInput', analysis: 'AudioRegionAnalysis', attribution: 'AudioHypothesisAttribution') -> 'dict'CLI
pocket audio-region-submit --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"AudioHypothesisAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "AudioHypothesisAttribution",
"type": "object"
},
"AudioHypothesisSettings": {
"additionalProperties": false,
"properties": {
"bpm_hint": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Bpm Hint"
},
"beats_per_bar": {
"title": "Beats Per Bar",
"type": "integer"
}
},
"required": [
"bpm_hint",
"beats_per_bar"
],
"title": "AudioHypothesisSettings",
"type": "object"
},
"AudioModelDeclaration": {
"additionalProperties": false,
"properties": {
"adapter": {
"const": "beat_this_cpu_v1",
"title": "Adapter",
"type": "string"
},
"executable": {
"$ref": "#/$defs/AudioModelFile"
},
"weights": {
"$ref": "#/$defs/AudioModelFile"
},
"expected_profile": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Expected Profile"
}
},
"required": [
"adapter",
"executable",
"weights",
"expected_profile"
],
"title": "AudioModelDeclaration",
"type": "object"
},
"AudioModelFile": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
}
},
"required": [
"path",
"sha256"
],
"title": "AudioModelFile",
"type": "object"
},
"AudioNoteModelDeclaration": {
"additionalProperties": false,
"properties": {
"adapter": {
"const": "basic_pitch_onnx_cpu_v1",
"title": "Adapter",
"type": "string"
},
"executable": {
"$ref": "#/$defs/AudioModelFile"
},
"weights": {
"$ref": "#/$defs/AudioModelFile"
},
"expected_profile": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Expected Profile"
}
},
"required": [
"adapter",
"executable",
"weights",
"expected_profile"
],
"title": "AudioNoteModelDeclaration",
"type": "object"
},
"AudioNoteSettings": {
"additionalProperties": false,
"properties": {
"device": {
"const": "cpu",
"title": "Device",
"type": "string"
},
"dtype": {
"const": "float32",
"title": "Dtype",
"type": "string"
},
"threads": {
"const": 1,
"title": "Threads",
"type": "integer"
},
"downmix": {
"const": "arithmetic_mean",
"title": "Downmix",
"type": "string"
},
"resampler": {
"const": "soxr_hq",
"title": "Resampler",
"type": "string"
},
"decoder": {
"enum": [
"basic_pitch_0_4_0_false_false_v1",
"basic_pitch_0_4_0_false_false_v2"
],
"title": "Decoder",
"type": "string"
},
"onset_threshold": {
"const": 0.5,
"title": "Onset Threshold",
"type": "number"
},
"frame_threshold": {
"const": 0.3,
"title": "Frame Threshold",
"type": "number"
},
"min_note_frames": {
"const": 11,
"title": "Min Note Frames",
"type": "integer"
},
"energy_tol": {
"const": 11,
"title": "Energy Tol",
"type": "integer"
},
"infer_onsets": {
"const": false,
"title": "Infer Onsets",
"type": "boolean"
},
"melodia_trick": {
"const": false,
"title": "Melodia Trick",
"type": "boolean"
}
},
"required": [
"device",
"dtype",
"threads",
"downmix",
"resampler",
"decoder",
"onset_threshold",
"frame_threshold",
"min_note_frames",
"energy_tol",
"infer_onsets",
"melodia_trick"
],
"title": "AudioNoteSettings",
"type": "object"
},
"AudioPulseSettings": {
"additionalProperties": false,
"properties": {
"device": {
"const": "cpu",
"title": "Device",
"type": "string"
},
"dtype": {
"const": "float32",
"title": "Dtype",
"type": "string"
},
"threads": {
"const": 1,
"title": "Threads",
"type": "integer"
},
"postprocessor": {
"const": "minimal",
"title": "Postprocessor",
"type": "string"
},
"downmix": {
"const": "arithmetic_mean",
"title": "Downmix",
"type": "string"
},
"resampler": {
"const": "soxr_hq",
"title": "Resampler",
"type": "string"
},
"seed": {
"const": 0,
"title": "Seed",
"type": "integer"
}
},
"required": [
"device",
"dtype",
"threads",
"postprocessor",
"downmix",
"resampler",
"seed"
],
"title": "AudioPulseSettings",
"type": "object"
},
"AudioRegionSource": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"frames": {
"title": "Frames",
"type": "integer"
},
"source_origin": {
"enum": [
"independently_acquired",
"user_recording"
],
"title": "Source Origin",
"type": "string"
}
},
"required": [
"path",
"expected_sha256",
"start_frame",
"frames",
"source_origin"
],
"title": "AudioRegionSource",
"type": "object"
},
"CapturedAudioRegion": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "captured",
"title": "Kind",
"type": "string"
},
"region": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"kind",
"region"
],
"title": "CapturedAudioRegion",
"type": "object"
},
"InlineAudioNoteModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inline",
"title": "Kind",
"type": "string"
},
"declaration": {
"$ref": "#/$defs/AudioNoteModelDeclaration"
},
"qualification": {
"const": "synthetic_onnx_cpu_v1",
"title": "Qualification",
"type": "string"
}
},
"required": [
"kind",
"declaration",
"qualification"
],
"title": "InlineAudioNoteModel",
"type": "object"
},
"InlineAudioPulseModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inline",
"title": "Kind",
"type": "string"
},
"declaration": {
"$ref": "#/$defs/AudioModelDeclaration"
},
"qualification": {
"const": "synthetic_cpu_v1",
"title": "Qualification",
"type": "string"
}
},
"required": [
"kind",
"declaration",
"qualification"
],
"title": "InlineAudioPulseModel",
"type": "object"
},
"InlineAudioRegion": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inline",
"title": "Kind",
"type": "string"
},
"source": {
"$ref": "#/$defs/AudioRegionSource"
}
},
"required": [
"kind",
"source"
],
"title": "InlineAudioRegion",
"type": "object"
},
"InspectedAudioNoteModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inspected",
"title": "Kind",
"type": "string"
},
"model": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"kind",
"model"
],
"title": "InspectedAudioNoteModel",
"type": "object"
},
"InspectedAudioPulseModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inspected",
"title": "Kind",
"type": "string"
},
"model": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"kind",
"model"
],
"title": "InspectedAudioPulseModel",
"type": "object"
},
"LearnedNoteRegionAnalysis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "learned_notes",
"title": "Kind",
"type": "string"
},
"model": {
"anyOf": [
{
"$ref": "#/$defs/InlineAudioNoteModel"
},
{
"$ref": "#/$defs/InspectedAudioNoteModel"
}
],
"title": "Model"
},
"settings": {
"$ref": "#/$defs/AudioNoteSettings"
}
},
"required": [
"kind",
"model",
"settings"
],
"title": "LearnedNoteRegionAnalysis",
"type": "object"
},
"LearnedPulseRegionAnalysis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "learned_pulse",
"title": "Kind",
"type": "string"
},
"model": {
"anyOf": [
{
"$ref": "#/$defs/InlineAudioPulseModel"
},
{
"$ref": "#/$defs/InspectedAudioPulseModel"
}
],
"title": "Model"
},
"settings": {
"$ref": "#/$defs/AudioPulseSettings"
}
},
"required": [
"kind",
"model",
"settings"
],
"title": "LearnedPulseRegionAnalysis",
"type": "object"
},
"PeekRegionAnalysis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "peek",
"title": "Kind",
"type": "string"
},
"settings": {
"$ref": "#/$defs/AudioHypothesisSettings"
}
},
"required": [
"kind",
"settings"
],
"title": "PeekRegionAnalysis",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"region": {
"anyOf": [
{
"$ref": "#/$defs/InlineAudioRegion"
},
{
"$ref": "#/$defs/CapturedAudioRegion"
}
],
"title": "Region"
},
"analysis": {
"anyOf": [
{
"$ref": "#/$defs/PeekRegionAnalysis"
},
{
"$ref": "#/$defs/LearnedPulseRegionAnalysis"
},
{
"$ref": "#/$defs/LearnedNoteRegionAnalysis"
}
],
"title": "Analysis"
},
"attribution": {
"$ref": "#/$defs/AudioHypothesisAttribution"
}
},
"required": [
"store_root",
"request_id",
"region",
"analysis",
"attribution"
],
"title": "audio_region_submitArguments",
"type": "object",
"additionalProperties": false
}audio_model_inspect Inspect an explicit optional local model runtime and checkpoint; optional bounded synthetic qualification, no downloads.
Domain: audio. Read only: false.
Python
pocket_music.audio_pulse_hypotheses.audio_model_inspect(*, store_root: 'str', request_id: 'str', declaration: 'AudioModelDeclaration', qualification: "Literal['none', 'synthetic_cpu_v1']" = 'none') -> 'dict'CLI
pocket audio-model-inspect --spec <arguments.json>MCP input schema
{
"$defs": {
"AudioModelDeclaration": {
"additionalProperties": false,
"properties": {
"adapter": {
"const": "beat_this_cpu_v1",
"title": "Adapter",
"type": "string"
},
"executable": {
"$ref": "#/$defs/AudioModelFile"
},
"weights": {
"$ref": "#/$defs/AudioModelFile"
},
"expected_profile": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Expected Profile"
}
},
"required": [
"adapter",
"executable",
"weights",
"expected_profile"
],
"title": "AudioModelDeclaration",
"type": "object"
},
"AudioModelFile": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
}
},
"required": [
"path",
"sha256"
],
"title": "AudioModelFile",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"declaration": {
"$ref": "#/$defs/AudioModelDeclaration"
},
"qualification": {
"default": "none",
"enum": [
"none",
"synthetic_cpu_v1"
],
"title": "Qualification",
"type": "string"
}
},
"required": [
"store_root",
"request_id",
"declaration"
],
"title": "audio_model_inspectArguments",
"type": "object",
"additionalProperties": false
}audio_pulse_hypotheses Retain uncertain learned pulses with exact source frames and explicit qualified local model provenance.
Domain: audio. Read only: false.
Python
pocket_music.audio_pulse_hypotheses.audio_pulse_hypotheses(*, store_root: 'str', request_id: 'str', source: 'AudioHypothesisSource', model: 'AudioPulseModel', settings: 'AudioPulseSettings', attribution: 'AudioHypothesisAttribution') -> 'dict'CLI
pocket audio-pulse-hypotheses --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"AudioHypothesisAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "AudioHypothesisAttribution",
"type": "object"
},
"AudioHypothesisSource": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"frames": {
"title": "Frames",
"type": "integer"
},
"source_origin": {
"enum": [
"independently_acquired",
"user_recording"
],
"title": "Source Origin",
"type": "string"
}
},
"required": [
"path",
"expected_sha256",
"start_frame",
"frames",
"source_origin"
],
"title": "AudioHypothesisSource",
"type": "object"
},
"AudioModelDeclaration": {
"additionalProperties": false,
"properties": {
"adapter": {
"const": "beat_this_cpu_v1",
"title": "Adapter",
"type": "string"
},
"executable": {
"$ref": "#/$defs/AudioModelFile"
},
"weights": {
"$ref": "#/$defs/AudioModelFile"
},
"expected_profile": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Expected Profile"
}
},
"required": [
"adapter",
"executable",
"weights",
"expected_profile"
],
"title": "AudioModelDeclaration",
"type": "object"
},
"AudioModelFile": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
}
},
"required": [
"path",
"sha256"
],
"title": "AudioModelFile",
"type": "object"
},
"AudioPulseSettings": {
"additionalProperties": false,
"properties": {
"device": {
"const": "cpu",
"title": "Device",
"type": "string"
},
"dtype": {
"const": "float32",
"title": "Dtype",
"type": "string"
},
"threads": {
"const": 1,
"title": "Threads",
"type": "integer"
},
"postprocessor": {
"const": "minimal",
"title": "Postprocessor",
"type": "string"
},
"downmix": {
"const": "arithmetic_mean",
"title": "Downmix",
"type": "string"
},
"resampler": {
"const": "soxr_hq",
"title": "Resampler",
"type": "string"
},
"seed": {
"const": 0,
"title": "Seed",
"type": "integer"
}
},
"required": [
"device",
"dtype",
"threads",
"postprocessor",
"downmix",
"resampler",
"seed"
],
"title": "AudioPulseSettings",
"type": "object"
},
"InlineAudioPulseModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inline",
"title": "Kind",
"type": "string"
},
"declaration": {
"$ref": "#/$defs/AudioModelDeclaration"
},
"qualification": {
"const": "synthetic_cpu_v1",
"title": "Qualification",
"type": "string"
}
},
"required": [
"kind",
"declaration",
"qualification"
],
"title": "InlineAudioPulseModel",
"type": "object"
},
"InspectedAudioPulseModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inspected",
"title": "Kind",
"type": "string"
},
"model": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"kind",
"model"
],
"title": "InspectedAudioPulseModel",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"source": {
"$ref": "#/$defs/AudioHypothesisSource"
},
"model": {
"anyOf": [
{
"$ref": "#/$defs/InlineAudioPulseModel"
},
{
"$ref": "#/$defs/InspectedAudioPulseModel"
}
],
"title": "Model"
},
"settings": {
"$ref": "#/$defs/AudioPulseSettings"
},
"attribution": {
"$ref": "#/$defs/AudioHypothesisAttribution"
}
},
"required": [
"store_root",
"request_id",
"source",
"model",
"settings",
"attribution"
],
"title": "audio_pulse_hypothesesArguments",
"type": "object",
"additionalProperties": false
}audio_pulse_submit Submit the same optional learned-pulse primitive with inherited execution ownership and cooperative cancellation.
Domain: audio. Read only: false.
Python
pocket_music.audio_hypothesis_jobs.audio_pulse_submit(*, store_root: 'str', request_id: 'str', source: 'AudioHypothesisSource', model: 'AudioPulseModel', settings: 'AudioPulseSettings', attribution: 'AudioHypothesisAttribution') -> 'dict'CLI
pocket audio-pulse-submit --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"AudioHypothesisAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "AudioHypothesisAttribution",
"type": "object"
},
"AudioHypothesisSource": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"frames": {
"title": "Frames",
"type": "integer"
},
"source_origin": {
"enum": [
"independently_acquired",
"user_recording"
],
"title": "Source Origin",
"type": "string"
}
},
"required": [
"path",
"expected_sha256",
"start_frame",
"frames",
"source_origin"
],
"title": "AudioHypothesisSource",
"type": "object"
},
"AudioModelDeclaration": {
"additionalProperties": false,
"properties": {
"adapter": {
"const": "beat_this_cpu_v1",
"title": "Adapter",
"type": "string"
},
"executable": {
"$ref": "#/$defs/AudioModelFile"
},
"weights": {
"$ref": "#/$defs/AudioModelFile"
},
"expected_profile": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Expected Profile"
}
},
"required": [
"adapter",
"executable",
"weights",
"expected_profile"
],
"title": "AudioModelDeclaration",
"type": "object"
},
"AudioModelFile": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
}
},
"required": [
"path",
"sha256"
],
"title": "AudioModelFile",
"type": "object"
},
"AudioPulseSettings": {
"additionalProperties": false,
"properties": {
"device": {
"const": "cpu",
"title": "Device",
"type": "string"
},
"dtype": {
"const": "float32",
"title": "Dtype",
"type": "string"
},
"threads": {
"const": 1,
"title": "Threads",
"type": "integer"
},
"postprocessor": {
"const": "minimal",
"title": "Postprocessor",
"type": "string"
},
"downmix": {
"const": "arithmetic_mean",
"title": "Downmix",
"type": "string"
},
"resampler": {
"const": "soxr_hq",
"title": "Resampler",
"type": "string"
},
"seed": {
"const": 0,
"title": "Seed",
"type": "integer"
}
},
"required": [
"device",
"dtype",
"threads",
"postprocessor",
"downmix",
"resampler",
"seed"
],
"title": "AudioPulseSettings",
"type": "object"
},
"InlineAudioPulseModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inline",
"title": "Kind",
"type": "string"
},
"declaration": {
"$ref": "#/$defs/AudioModelDeclaration"
},
"qualification": {
"const": "synthetic_cpu_v1",
"title": "Qualification",
"type": "string"
}
},
"required": [
"kind",
"declaration",
"qualification"
],
"title": "InlineAudioPulseModel",
"type": "object"
},
"InspectedAudioPulseModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inspected",
"title": "Kind",
"type": "string"
},
"model": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"kind",
"model"
],
"title": "InspectedAudioPulseModel",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"source": {
"$ref": "#/$defs/AudioHypothesisSource"
},
"model": {
"anyOf": [
{
"$ref": "#/$defs/InlineAudioPulseModel"
},
{
"$ref": "#/$defs/InspectedAudioPulseModel"
}
],
"title": "Model"
},
"settings": {
"$ref": "#/$defs/AudioPulseSettings"
},
"attribution": {
"$ref": "#/$defs/AudioHypothesisAttribution"
}
},
"required": [
"store_root",
"request_id",
"source",
"model",
"settings",
"attribution"
],
"title": "audio_pulse_submitArguments",
"type": "object",
"additionalProperties": false
}audio_note_model_inspect Inspect an explicit optional known-weight ONNX CPU runtime; bounded synthetic qualification, no downloads.
Domain: audio. Read only: false.
Python
pocket_music.audio_note_hypotheses.audio_note_model_inspect(*, store_root: 'str', request_id: 'str', declaration: 'AudioNoteModelDeclaration', qualification: "Literal['none', 'synthetic_onnx_cpu_v1']" = 'none') -> 'dict'CLI
pocket audio-note-model-inspect --spec <arguments.json>MCP input schema
{
"$defs": {
"AudioModelFile": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
}
},
"required": [
"path",
"sha256"
],
"title": "AudioModelFile",
"type": "object"
},
"AudioNoteModelDeclaration": {
"additionalProperties": false,
"properties": {
"adapter": {
"const": "basic_pitch_onnx_cpu_v1",
"title": "Adapter",
"type": "string"
},
"executable": {
"$ref": "#/$defs/AudioModelFile"
},
"weights": {
"$ref": "#/$defs/AudioModelFile"
},
"expected_profile": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Expected Profile"
}
},
"required": [
"adapter",
"executable",
"weights",
"expected_profile"
],
"title": "AudioNoteModelDeclaration",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"declaration": {
"$ref": "#/$defs/AudioNoteModelDeclaration"
},
"qualification": {
"default": "none",
"enum": [
"none",
"synthetic_onnx_cpu_v1"
],
"title": "Qualification",
"type": "string"
}
},
"required": [
"store_root",
"request_id",
"declaration"
],
"title": "audio_note_model_inspectArguments",
"type": "object",
"additionalProperties": false
}audio_note_hypotheses Retain uncertain note candidates with complete window tensors, source-frame envelopes and explicit model provenance.
Domain: audio. Read only: false.
Python
pocket_music.audio_note_hypotheses.audio_note_hypotheses(*, store_root: 'str', request_id: 'str', source: 'AudioHypothesisSource', model: 'AudioNoteModel', settings: 'AudioNoteSettings', attribution: 'AudioHypothesisAttribution') -> 'dict'CLI
pocket audio-note-hypotheses --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"AudioHypothesisAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "AudioHypothesisAttribution",
"type": "object"
},
"AudioHypothesisSource": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"frames": {
"title": "Frames",
"type": "integer"
},
"source_origin": {
"enum": [
"independently_acquired",
"user_recording"
],
"title": "Source Origin",
"type": "string"
}
},
"required": [
"path",
"expected_sha256",
"start_frame",
"frames",
"source_origin"
],
"title": "AudioHypothesisSource",
"type": "object"
},
"AudioModelFile": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
}
},
"required": [
"path",
"sha256"
],
"title": "AudioModelFile",
"type": "object"
},
"AudioNoteModelDeclaration": {
"additionalProperties": false,
"properties": {
"adapter": {
"const": "basic_pitch_onnx_cpu_v1",
"title": "Adapter",
"type": "string"
},
"executable": {
"$ref": "#/$defs/AudioModelFile"
},
"weights": {
"$ref": "#/$defs/AudioModelFile"
},
"expected_profile": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Expected Profile"
}
},
"required": [
"adapter",
"executable",
"weights",
"expected_profile"
],
"title": "AudioNoteModelDeclaration",
"type": "object"
},
"AudioNoteSettings": {
"additionalProperties": false,
"properties": {
"device": {
"const": "cpu",
"title": "Device",
"type": "string"
},
"dtype": {
"const": "float32",
"title": "Dtype",
"type": "string"
},
"threads": {
"const": 1,
"title": "Threads",
"type": "integer"
},
"downmix": {
"const": "arithmetic_mean",
"title": "Downmix",
"type": "string"
},
"resampler": {
"const": "soxr_hq",
"title": "Resampler",
"type": "string"
},
"decoder": {
"enum": [
"basic_pitch_0_4_0_false_false_v1",
"basic_pitch_0_4_0_false_false_v2"
],
"title": "Decoder",
"type": "string"
},
"onset_threshold": {
"const": 0.5,
"title": "Onset Threshold",
"type": "number"
},
"frame_threshold": {
"const": 0.3,
"title": "Frame Threshold",
"type": "number"
},
"min_note_frames": {
"const": 11,
"title": "Min Note Frames",
"type": "integer"
},
"energy_tol": {
"const": 11,
"title": "Energy Tol",
"type": "integer"
},
"infer_onsets": {
"const": false,
"title": "Infer Onsets",
"type": "boolean"
},
"melodia_trick": {
"const": false,
"title": "Melodia Trick",
"type": "boolean"
}
},
"required": [
"device",
"dtype",
"threads",
"downmix",
"resampler",
"decoder",
"onset_threshold",
"frame_threshold",
"min_note_frames",
"energy_tol",
"infer_onsets",
"melodia_trick"
],
"title": "AudioNoteSettings",
"type": "object"
},
"InlineAudioNoteModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inline",
"title": "Kind",
"type": "string"
},
"declaration": {
"$ref": "#/$defs/AudioNoteModelDeclaration"
},
"qualification": {
"const": "synthetic_onnx_cpu_v1",
"title": "Qualification",
"type": "string"
}
},
"required": [
"kind",
"declaration",
"qualification"
],
"title": "InlineAudioNoteModel",
"type": "object"
},
"InspectedAudioNoteModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inspected",
"title": "Kind",
"type": "string"
},
"model": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"kind",
"model"
],
"title": "InspectedAudioNoteModel",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"source": {
"$ref": "#/$defs/AudioHypothesisSource"
},
"model": {
"anyOf": [
{
"$ref": "#/$defs/InlineAudioNoteModel"
},
{
"$ref": "#/$defs/InspectedAudioNoteModel"
}
],
"title": "Model"
},
"settings": {
"$ref": "#/$defs/AudioNoteSettings"
},
"attribution": {
"$ref": "#/$defs/AudioHypothesisAttribution"
}
},
"required": [
"store_root",
"request_id",
"source",
"model",
"settings",
"attribution"
],
"title": "audio_note_hypothesesArguments",
"type": "object",
"additionalProperties": false
}audio_note_submit Run the same optional note primitive with inherited execution ownership and revision-checked cancellation.
Domain: audio. Read only: false.
Python
pocket_music.audio_note_jobs.audio_note_submit(*, store_root: 'str', request_id: 'str', source: 'AudioHypothesisSource', model: 'AudioNoteModel', settings: 'AudioNoteSettings', attribution: 'AudioHypothesisAttribution') -> 'dict'CLI
pocket audio-note-submit --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"AudioHypothesisAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "AudioHypothesisAttribution",
"type": "object"
},
"AudioHypothesisSource": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"frames": {
"title": "Frames",
"type": "integer"
},
"source_origin": {
"enum": [
"independently_acquired",
"user_recording"
],
"title": "Source Origin",
"type": "string"
}
},
"required": [
"path",
"expected_sha256",
"start_frame",
"frames",
"source_origin"
],
"title": "AudioHypothesisSource",
"type": "object"
},
"AudioModelFile": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
}
},
"required": [
"path",
"sha256"
],
"title": "AudioModelFile",
"type": "object"
},
"AudioNoteModelDeclaration": {
"additionalProperties": false,
"properties": {
"adapter": {
"const": "basic_pitch_onnx_cpu_v1",
"title": "Adapter",
"type": "string"
},
"executable": {
"$ref": "#/$defs/AudioModelFile"
},
"weights": {
"$ref": "#/$defs/AudioModelFile"
},
"expected_profile": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Expected Profile"
}
},
"required": [
"adapter",
"executable",
"weights",
"expected_profile"
],
"title": "AudioNoteModelDeclaration",
"type": "object"
},
"AudioNoteSettings": {
"additionalProperties": false,
"properties": {
"device": {
"const": "cpu",
"title": "Device",
"type": "string"
},
"dtype": {
"const": "float32",
"title": "Dtype",
"type": "string"
},
"threads": {
"const": 1,
"title": "Threads",
"type": "integer"
},
"downmix": {
"const": "arithmetic_mean",
"title": "Downmix",
"type": "string"
},
"resampler": {
"const": "soxr_hq",
"title": "Resampler",
"type": "string"
},
"decoder": {
"enum": [
"basic_pitch_0_4_0_false_false_v1",
"basic_pitch_0_4_0_false_false_v2"
],
"title": "Decoder",
"type": "string"
},
"onset_threshold": {
"const": 0.5,
"title": "Onset Threshold",
"type": "number"
},
"frame_threshold": {
"const": 0.3,
"title": "Frame Threshold",
"type": "number"
},
"min_note_frames": {
"const": 11,
"title": "Min Note Frames",
"type": "integer"
},
"energy_tol": {
"const": 11,
"title": "Energy Tol",
"type": "integer"
},
"infer_onsets": {
"const": false,
"title": "Infer Onsets",
"type": "boolean"
},
"melodia_trick": {
"const": false,
"title": "Melodia Trick",
"type": "boolean"
}
},
"required": [
"device",
"dtype",
"threads",
"downmix",
"resampler",
"decoder",
"onset_threshold",
"frame_threshold",
"min_note_frames",
"energy_tol",
"infer_onsets",
"melodia_trick"
],
"title": "AudioNoteSettings",
"type": "object"
},
"InlineAudioNoteModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inline",
"title": "Kind",
"type": "string"
},
"declaration": {
"$ref": "#/$defs/AudioNoteModelDeclaration"
},
"qualification": {
"const": "synthetic_onnx_cpu_v1",
"title": "Qualification",
"type": "string"
}
},
"required": [
"kind",
"declaration",
"qualification"
],
"title": "InlineAudioNoteModel",
"type": "object"
},
"InspectedAudioNoteModel": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "inspected",
"title": "Kind",
"type": "string"
},
"model": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"kind",
"model"
],
"title": "InspectedAudioNoteModel",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"source": {
"$ref": "#/$defs/AudioHypothesisSource"
},
"model": {
"anyOf": [
{
"$ref": "#/$defs/InlineAudioNoteModel"
},
{
"$ref": "#/$defs/InspectedAudioNoteModel"
}
],
"title": "Model"
},
"settings": {
"$ref": "#/$defs/AudioNoteSettings"
},
"attribution": {
"$ref": "#/$defs/AudioHypothesisAttribution"
}
},
"required": [
"store_root",
"request_id",
"source",
"model",
"settings",
"attribution"
],
"title": "audio_note_submitArguments",
"type": "object",
"additionalProperties": false
}audio_hypothesis_correct Attributed immutable corrections retaining original hypotheses and uncertainty.
Domain: audio. Read only: false.
Python
pocket_music.audio_hypotheses.audio_hypothesis_correct(*, store_root: 'str', request_id: 'str', parent: 'ArtifactHandle', expected_revision: 'str', corrections: 'list[AudioHypothesisCorrection]', attribution: 'AudioHypothesisAttribution') -> 'dict'CLI
pocket audio-hypothesis-correct --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"AttackHypothesis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "attack",
"title": "Kind",
"type": "string"
},
"source_frame": {
"title": "Source Frame",
"type": "integer"
},
"strength_relative": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Strength Relative"
}
},
"required": [
"kind",
"source_frame",
"strength_relative"
],
"title": "AttackHypothesis",
"type": "object"
},
"AudioEvidenceSupport": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"analysis_pointer",
"annotation_id"
],
"title": "Kind",
"type": "string"
},
"reference": {
"title": "Reference",
"type": "string"
}
},
"required": [
"kind",
"reference"
],
"title": "AudioEvidenceSupport",
"type": "object"
},
"AudioHypothesisAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "AudioHypothesisAttribution",
"type": "object"
},
"AudioHypothesisCorrection": {
"additionalProperties": false,
"properties": {
"correction_id": {
"title": "Correction Id",
"type": "string"
},
"supersedes": {
"items": {
"type": "string"
},
"title": "Supersedes",
"type": "array"
},
"annotation": {
"anyOf": [
{
"$ref": "#/$defs/AttackHypothesis"
},
{
"$ref": "#/$defs/PulseHypothesis"
},
{
"$ref": "#/$defs/PhraseAnchorHypothesis"
},
{
"$ref": "#/$defs/NoteHypothesis"
}
],
"title": "Annotation"
},
"support": {
"items": {
"$ref": "#/$defs/AudioEvidenceSupport"
},
"title": "Support",
"type": "array"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"correction_id",
"supersedes",
"annotation",
"support",
"uncertainty"
],
"title": "AudioHypothesisCorrection",
"type": "object"
},
"NoteHypothesis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "note_hypothesis",
"title": "Kind",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"end_frame_exclusive": {
"title": "End Frame Exclusive",
"type": "integer"
},
"midi_note": {
"title": "Midi Note",
"type": "integer"
},
"cents": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
}
],
"title": "Cents"
},
"tuning_ref": {
"title": "Tuning Ref",
"type": "string"
}
},
"required": [
"kind",
"start_frame",
"end_frame_exclusive",
"midi_note",
"cents",
"tuning_ref"
],
"title": "NoteHypothesis",
"type": "object"
},
"PhraseAnchorHypothesis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "phrase_anchor",
"title": "Kind",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"end_frame_exclusive": {
"title": "End Frame Exclusive",
"type": "integer"
},
"label": {
"title": "Label",
"type": "string"
}
},
"required": [
"kind",
"start_frame",
"end_frame_exclusive",
"label"
],
"title": "PhraseAnchorHypothesis",
"type": "object"
},
"PulseHypothesis": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "pulse_candidate",
"title": "Kind",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"end_frame_exclusive": {
"title": "End Frame Exclusive",
"type": "integer"
},
"bpm": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
}
],
"title": "Bpm"
},
"source_lattice_origin_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
}
],
"title": "Source Lattice Origin Seconds"
}
},
"required": [
"kind",
"start_frame",
"end_frame_exclusive",
"bpm",
"source_lattice_origin_seconds"
],
"title": "PulseHypothesis",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"parent": {
"$ref": "#/$defs/ArtifactHandle"
},
"expected_revision": {
"title": "Expected Revision",
"type": "string"
},
"corrections": {
"items": {
"$ref": "#/$defs/AudioHypothesisCorrection"
},
"title": "Corrections",
"type": "array"
},
"attribution": {
"$ref": "#/$defs/AudioHypothesisAttribution"
}
},
"required": [
"store_root",
"request_id",
"parent",
"expected_revision",
"corrections",
"attribution"
],
"title": "audio_hypothesis_correctArguments",
"type": "object",
"additionalProperties": false
}audio_hypothesis_query Bounded revision-bound audio evidence, annotation and correction retrieval.
Domain: audio. Read only: true.
Python
pocket_music.audio_hypotheses.audio_hypothesis_query(*, store_root: 'str', hypotheses: 'ArtifactHandle', view: "Literal['summary', 'annotations', 'history']" = 'summary', limit: 'int' = 32, cursor: 'str | None' = None, max_bytes: 'int' = 16384) -> 'dict'CLI
pocket audio-hypothesis-query --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"hypotheses": {
"$ref": "#/$defs/ArtifactHandle"
},
"view": {
"default": "summary",
"enum": [
"summary",
"annotations",
"history"
],
"title": "View",
"type": "string"
},
"limit": {
"default": 32,
"title": "Limit",
"type": "integer"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cursor"
},
"max_bytes": {
"default": 16384,
"title": "Max Bytes",
"type": "integer"
}
},
"required": [
"store_root",
"hypotheses"
],
"title": "audio_hypothesis_queryArguments",
"type": "object",
"additionalProperties": false
}audio_hypothesis_submit Snapshot local audio and submit the same primitive to an optional owned POSIX worker.
Domain: audio. Read only: false.
Python
pocket_music.audio_hypothesis_jobs.audio_hypothesis_submit(store_root: 'str', request_id: 'str', source: 'AudioHypothesisSource', settings: 'AudioHypothesisSettings', attribution: 'AudioHypothesisAttribution') -> 'dict'CLI
pocket audio-hypothesis-submit --spec <arguments.json>MCP input schema
{
"$defs": {
"AudioHypothesisAttribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "AudioHypothesisAttribution",
"type": "object"
},
"AudioHypothesisSettings": {
"additionalProperties": false,
"properties": {
"bpm_hint": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Bpm Hint"
},
"beats_per_bar": {
"title": "Beats Per Bar",
"type": "integer"
}
},
"required": [
"bpm_hint",
"beats_per_bar"
],
"title": "AudioHypothesisSettings",
"type": "object"
},
"AudioHypothesisSource": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"start_frame": {
"title": "Start Frame",
"type": "integer"
},
"frames": {
"title": "Frames",
"type": "integer"
},
"source_origin": {
"enum": [
"independently_acquired",
"user_recording"
],
"title": "Source Origin",
"type": "string"
}
},
"required": [
"path",
"expected_sha256",
"start_frame",
"frames",
"source_origin"
],
"title": "AudioHypothesisSource",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"source": {
"$ref": "#/$defs/AudioHypothesisSource"
},
"settings": {
"$ref": "#/$defs/AudioHypothesisSettings"
},
"attribution": {
"$ref": "#/$defs/AudioHypothesisAttribution"
}
},
"required": [
"store_root",
"request_id",
"source",
"settings",
"attribution"
],
"title": "audio_hypothesis_submitArguments",
"type": "object",
"additionalProperties": false
}job_status Inspect an analysis job and reconcile a released execution lease without retry.
Domain: job. Read only: false.
Python
pocket_music.audio_hypothesis_jobs.job_status(store_root: 'str', job_id: 'str') -> 'dict'CLI
pocket job-status --spec <arguments.json>MCP input schema
{
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"store_root",
"job_id"
],
"title": "job_statusArguments",
"type": "object",
"additionalProperties": false
}job_cancel Request cancellation at the next analysis boundary using an exact job revision.
Domain: job. Read only: false.
Python
pocket_music.audio_hypothesis_jobs.job_cancel(store_root: 'str', job_id: 'str', expected_revision: 'str') -> 'dict'CLI
pocket job-cancel --spec <arguments.json>MCP input schema
{
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"job_id": {
"title": "Job Id",
"type": "string"
},
"expected_revision": {
"title": "Expected Revision",
"type": "string"
}
},
"required": [
"store_root",
"job_id",
"expected_revision"
],
"title": "job_cancelArguments",
"type": "object",
"additionalProperties": false
}curve_transform File-only control curves; native execution separately gated.
Domain: expression. Read only: false.
Python
pocket_music.curves.curve_transform(*, store_root: 'str', request_id: 'str', operations: 'list[CurveOperation]', curve: 'ArtifactHandle | None' = None, target: 'CurveTarget | None' = None, context: 'ArtifactHandle | None' = None, conflict_policy: "Literal['reject_existing', 'plan_override']" = 'reject_existing', allow_discontinuity_change: 'bool' = False) -> 'dict'CLI
pocket curve-transform --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"CurveOperation": {
"additionalProperties": false,
"properties": {
"op": {
"enum": [
"create",
"shift",
"scale_time",
"scale_value",
"offset",
"smooth",
"simplify",
"splice"
],
"title": "Op",
"type": "string"
},
"points": {
"items": {
"$ref": "#/$defs/CurvePoint"
},
"title": "Points",
"type": "array"
},
"space": {
"enum": [
"arrangement_qn",
"clip_qn",
"phrase_qn",
"note_relative_qn"
],
"title": "Space",
"type": "string"
},
"interpolation": {
"enum": [
"linear",
"step"
],
"title": "Interpolation",
"type": "string"
},
"amount": {
"anyOf": [
{
"$ref": "#/$defs/RationalTime"
},
{
"type": "number"
}
],
"title": "Amount"
},
"factor": {
"anyOf": [
{
"$ref": "#/$defs/RationalTime"
},
{
"type": "number"
}
],
"title": "Factor"
},
"origin": {
"$ref": "#/$defs/RationalTime"
},
"window": {
"title": "Window",
"type": "integer"
},
"tolerance": {
"title": "Tolerance",
"type": "number"
},
"start": {
"$ref": "#/$defs/RationalTime"
},
"end": {
"$ref": "#/$defs/RationalTime"
}
},
"title": "CurveOperation",
"type": "object"
},
"CurvePoint": {
"additionalProperties": false,
"properties": {
"time": {
"$ref": "#/$defs/RationalTime"
},
"value": {
"title": "Value",
"type": "number"
},
"order": {
"title": "Order",
"type": "integer"
}
},
"required": [
"time",
"value",
"order"
],
"title": "CurvePoint",
"type": "object"
},
"CurveTarget": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"cc",
"pitch_bend",
"channel_pressure",
"per_note_pitch",
"per_note_pressure",
"per_note_slide",
"host_parameter",
"macro"
],
"title": "Kind",
"type": "string"
},
"target_id": {
"title": "Target Id",
"type": "string"
},
"scope": {
"enum": [
"channel",
"note",
"instance"
],
"title": "Scope",
"type": "string"
},
"unit": {
"title": "Unit",
"type": "string"
},
"value_min": {
"title": "Value Min",
"type": "number"
},
"value_max": {
"title": "Value Max",
"type": "number"
},
"quantized": {
"title": "Quantized",
"type": "boolean"
},
"values": {
"items": {
"type": "number"
},
"title": "Values",
"type": "array"
},
"ownership": {
"enum": [
"none",
"host_automation",
"macro",
"remote",
"unknown"
],
"title": "Ownership",
"type": "string"
},
"value_mode": {
"enum": [
"absolute",
"additive",
"multiplicative"
],
"title": "Value Mode",
"type": "string"
},
"channel": {
"title": "Channel",
"type": "integer"
},
"note_id": {
"title": "Note Id",
"type": "string"
},
"resize_policy": {
"enum": [
"stretch_with_gate",
"preserve_fraction",
"crop",
"preserve_ms"
],
"title": "Resize Policy",
"type": "string"
},
"parameter_layout_sha256": {
"title": "Parameter Layout Sha256",
"type": "string"
}
},
"required": [
"kind",
"target_id",
"scope",
"unit",
"value_min",
"value_max",
"quantized",
"values",
"ownership",
"value_mode"
],
"title": "CurveTarget",
"type": "object"
},
"RationalTime": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "RationalTime",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"operations": {
"items": {
"$ref": "#/$defs/CurveOperation"
},
"title": "Operations",
"type": "array"
},
"curve": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"target": {
"anyOf": [
{
"$ref": "#/$defs/CurveTarget"
},
{
"type": "null"
}
],
"default": null
},
"context": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"conflict_policy": {
"default": "reject_existing",
"enum": [
"reject_existing",
"plan_override"
],
"title": "Conflict Policy",
"type": "string"
},
"allow_discontinuity_change": {
"default": false,
"title": "Allow Discontinuity Change",
"type": "boolean"
}
},
"required": [
"store_root",
"request_id",
"operations"
],
"title": "curve_transformArguments",
"type": "object",
"additionalProperties": false
}musical_time Exact declared step-tempo clocks, meter displays and independent local cycles.
Domain: time. Read only: false.
Python
pocket_music.time_maps.musical_time(operation: "Literal['create', 'convert', 'query']", store_root: 'str', request_id: 'str | None' = None, definition: 'TimeMapDefinition | None' = None, time_map: 'ArtifactHandle | None' = None, positions: 'list[TimePosition] | None' = None, target_space: "Literal['arrangement_qn', 'host_seconds', 'render_frame', 'bar_display'] | None" = None, quantization: 'FrameQuantization | None' = None, section: "Literal['summary', 'tempo', 'meter', 'cycles']" = 'summary', offset: 'int' = 0, limit: 'int' = 100) -> 'dict'CLI
pocket musical-time --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"FrameQuantization": {
"additionalProperties": false,
"properties": {
"policy": {
"const": "nearest_half_away_from_zero",
"title": "Policy",
"type": "string"
},
"max_error_frames": {
"$ref": "#/$defs/Rational"
}
},
"required": [
"policy",
"max_error_frames"
],
"title": "FrameQuantization",
"type": "object"
},
"HostOrigin": {
"additionalProperties": false,
"properties": {
"arrangement_qn": {
"$ref": "#/$defs/Rational"
},
"host_seconds": {
"$ref": "#/$defs/Rational"
}
},
"required": [
"arrangement_qn",
"host_seconds"
],
"title": "HostOrigin",
"type": "object"
},
"LocalCycle": {
"additionalProperties": false,
"properties": {
"cycle_id": {
"title": "Cycle Id",
"type": "string"
},
"origin_qn": {
"$ref": "#/$defs/Rational"
},
"length_qn": {
"$ref": "#/$defs/Rational"
},
"annotation": {
"title": "Annotation",
"type": "string"
}
},
"required": [
"cycle_id",
"origin_qn",
"length_qn",
"annotation"
],
"title": "LocalCycle",
"type": "object"
},
"MeterSegment": {
"additionalProperties": false,
"properties": {
"at_qn": {
"$ref": "#/$defs/Rational"
},
"numerator": {
"title": "Numerator",
"type": "integer"
},
"denominator": {
"title": "Denominator",
"type": "integer"
},
"bar_number": {
"title": "Bar Number",
"type": "integer"
},
"partial_previous_bar": {
"title": "Partial Previous Bar",
"type": "boolean"
}
},
"required": [
"at_qn",
"numerator",
"denominator",
"bar_number",
"partial_previous_bar"
],
"title": "MeterSegment",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"RenderOrigin": {
"additionalProperties": false,
"properties": {
"audio": {
"$ref": "#/$defs/ArtifactHandle"
},
"host_seconds": {
"$ref": "#/$defs/Rational"
},
"frame": {
"title": "Frame",
"type": "integer"
},
"sample_rate": {
"title": "Sample Rate",
"type": "integer"
}
},
"required": [
"audio",
"host_seconds",
"frame",
"sample_rate"
],
"title": "RenderOrigin",
"type": "object"
},
"TempoStep": {
"additionalProperties": false,
"properties": {
"at_qn": {
"$ref": "#/$defs/Rational"
},
"bpm": {
"$ref": "#/$defs/Rational"
},
"interpolation": {
"const": "step",
"title": "Interpolation",
"type": "string"
}
},
"required": [
"at_qn",
"bpm",
"interpolation"
],
"title": "TempoStep",
"type": "object"
},
"TimeContext": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.time-context/v1",
"title": "Schema",
"type": "string"
},
"context_id": {
"title": "Context Id",
"type": "string"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"source": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"schema",
"context_id",
"attribution"
],
"title": "TimeContext",
"type": "object"
},
"TimeDomain": {
"additionalProperties": false,
"properties": {
"start": {
"$ref": "#/$defs/Rational"
},
"end": {
"$ref": "#/$defs/Rational"
}
},
"required": [
"start",
"end"
],
"title": "TimeDomain",
"type": "object"
},
"TimeMapDefinition": {
"additionalProperties": false,
"properties": {
"source_context": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"$ref": "#/$defs/TimeContext"
}
],
"title": "Source Context"
},
"domain_qn": {
"$ref": "#/$defs/TimeDomain"
},
"tempo": {
"items": {
"$ref": "#/$defs/TempoStep"
},
"title": "Tempo",
"type": "array"
},
"host_origin": {
"$ref": "#/$defs/HostOrigin"
},
"render_origin": {
"anyOf": [
{
"$ref": "#/$defs/RenderOrigin"
},
{
"type": "null"
}
]
},
"meter": {
"items": {
"$ref": "#/$defs/MeterSegment"
},
"title": "Meter",
"type": "array"
},
"bar_one_qn": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "null"
}
]
},
"cycles": {
"items": {
"$ref": "#/$defs/LocalCycle"
},
"title": "Cycles",
"type": "array"
}
},
"required": [
"source_context",
"domain_qn",
"tempo",
"host_origin"
],
"title": "TimeMapDefinition",
"type": "object"
},
"TimePosition": {
"additionalProperties": false,
"properties": {
"space": {
"enum": [
"arrangement_qn",
"host_seconds",
"render_frame"
],
"title": "Space",
"type": "string"
},
"value": {
"anyOf": [
{
"$ref": "#/$defs/Rational"
},
{
"type": "integer"
}
],
"title": "Value"
}
},
"required": [
"space",
"value"
],
"title": "TimePosition",
"type": "object"
}
},
"properties": {
"operation": {
"enum": [
"create",
"convert",
"query"
],
"title": "Operation",
"type": "string"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Request Id"
},
"definition": {
"anyOf": [
{
"$ref": "#/$defs/TimeMapDefinition"
},
{
"type": "null"
}
],
"default": null
},
"time_map": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"positions": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/TimePosition"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Positions"
},
"target_space": {
"anyOf": [
{
"enum": [
"arrangement_qn",
"host_seconds",
"render_frame",
"bar_display"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Target Space"
},
"quantization": {
"anyOf": [
{
"$ref": "#/$defs/FrameQuantization"
},
{
"type": "null"
}
],
"default": null
},
"section": {
"default": "summary",
"enum": [
"summary",
"tempo",
"meter",
"cycles"
],
"title": "Section",
"type": "string"
},
"offset": {
"default": 0,
"title": "Offset",
"type": "integer"
},
"limit": {
"default": 100,
"title": "Limit",
"type": "integer"
}
},
"required": [
"operation",
"store_root"
],
"title": "musical_timeArguments",
"type": "object",
"additionalProperties": false
}context_create Immutable musical context with explicit clocks, authored anchors and occurrence identities; no host required.
Domain: context. Read only: false.
Python
pocket_music.musical_context.context_create(store_root: 'str', request_id: 'str', definition: 'MusicalContextDefinition', parent: 'ArtifactHandle | None' = None) -> 'dict'CLI
pocket context-create --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"Attribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "Attribution",
"type": "object"
},
"ClockPosition": {
"additionalProperties": false,
"properties": {
"clock_id": {
"title": "Clock Id",
"type": "string"
},
"space": {
"enum": [
"source_frame",
"arrangement_qn",
"host_seconds",
"render_frame"
],
"title": "Space",
"type": "string"
},
"value": {
"anyOf": [
{
"type": "integer"
},
{
"$ref": "#/$defs/Rational"
}
],
"title": "Value"
}
},
"required": [
"clock_id",
"space",
"value"
],
"title": "ClockPosition",
"type": "object"
},
"MusicalAnchor": {
"additionalProperties": false,
"properties": {
"anchor_id": {
"title": "Anchor Id",
"type": "string"
},
"kind": {
"enum": [
"pulse",
"bar_one",
"phrase_start",
"onset",
"other"
],
"title": "Kind",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
},
"position": {
"$ref": "#/$defs/ClockPosition"
},
"attribution": {
"$ref": "#/$defs/Attribution"
}
},
"required": [
"anchor_id",
"kind",
"label",
"position",
"attribution"
],
"title": "MusicalAnchor",
"type": "object"
},
"MusicalContextDefinition": {
"additionalProperties": false,
"properties": {
"context_id": {
"title": "Context Id",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"attribution": {
"$ref": "#/$defs/Attribution"
},
"sources": {
"items": {
"$ref": "#/$defs/SourceClock"
},
"title": "Sources",
"type": "array"
},
"timelines": {
"items": {
"$ref": "#/$defs/TimelineClock"
},
"title": "Timelines",
"type": "array"
},
"occurrences": {
"items": {
"$ref": "#/$defs/Occurrence"
},
"title": "Occurrences",
"type": "array"
},
"anchors": {
"items": {
"$ref": "#/$defs/MusicalAnchor"
},
"title": "Anchors",
"type": "array"
},
"materials": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Materials",
"type": "array"
}
},
"required": [
"context_id",
"title",
"attribution",
"sources",
"timelines",
"occurrences",
"anchors",
"materials"
],
"title": "MusicalContextDefinition",
"type": "object"
},
"Occurrence": {
"additionalProperties": false,
"properties": {
"occurrence_id": {
"title": "Occurrence Id",
"type": "string"
},
"source_clock_id": {
"title": "Source Clock Id",
"type": "string"
},
"timeline_clock_id": {
"title": "Timeline Clock Id",
"type": "string"
},
"source_span_frames": {
"items": {
"type": "integer"
},
"title": "Source Span Frames",
"type": "array"
},
"timeline_span_qn": {
"items": {
"$ref": "#/$defs/Rational"
},
"title": "Timeline Span Qn",
"type": "array"
}
},
"required": [
"occurrence_id",
"source_clock_id",
"timeline_clock_id",
"source_span_frames",
"timeline_span_qn"
],
"title": "Occurrence",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"SourceClock": {
"additionalProperties": false,
"properties": {
"clock_id": {
"title": "Clock Id",
"type": "string"
},
"region": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"clock_id",
"region"
],
"title": "SourceClock",
"type": "object"
},
"TimelineClock": {
"additionalProperties": false,
"properties": {
"clock_id": {
"title": "Clock Id",
"type": "string"
},
"time_map": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"clock_id",
"time_map"
],
"title": "TimelineClock",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"definition": {
"$ref": "#/$defs/MusicalContextDefinition"
},
"parent": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"store_root",
"request_id",
"definition"
],
"title": "context_createArguments",
"type": "object",
"additionalProperties": false
}context_query Bounded pages of an exact musical context revision.
Domain: context. Read only: true.
Python
pocket_music.musical_context.context_query(store_root: 'str', context: 'ArtifactHandle', section: "Literal['summary', 'sources', 'timelines', 'occurrences', 'anchors', 'materials', 'bindings']" = 'summary', offset: 'int' = 0, limit: 'int' = 32) -> 'dict'CLI
pocket context-query --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"context": {
"$ref": "#/$defs/ArtifactHandle"
},
"section": {
"default": "summary",
"enum": [
"summary",
"sources",
"timelines",
"occurrences",
"anchors",
"materials",
"bindings"
],
"title": "Section",
"type": "string"
},
"offset": {
"default": 0,
"title": "Offset",
"type": "integer"
},
"limit": {
"default": 32,
"title": "Limit",
"type": "integer"
}
},
"required": [
"store_root",
"context"
],
"title": "context_queryArguments",
"type": "object",
"additionalProperties": false
}context_resolve Resolve an internal anchor or explicit position through a named occurrence; ambiguous mappings are refused.
Domain: context. Read only: true.
Python
pocket_music.musical_context.context_resolve(store_root: 'str', context: 'ArtifactHandle', target_clock_id: 'str', target_space: "Literal['source_frame', 'arrangement_qn', 'host_seconds', 'render_frame']", position: 'ClockPosition | None' = None, anchor_id: 'str | None' = None, occurrence_id: 'str | None' = None) -> 'dict'CLI
pocket context-resolve --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ClockPosition": {
"additionalProperties": false,
"properties": {
"clock_id": {
"title": "Clock Id",
"type": "string"
},
"space": {
"enum": [
"source_frame",
"arrangement_qn",
"host_seconds",
"render_frame"
],
"title": "Space",
"type": "string"
},
"value": {
"anyOf": [
{
"type": "integer"
},
{
"$ref": "#/$defs/Rational"
}
],
"title": "Value"
}
},
"required": [
"clock_id",
"space",
"value"
],
"title": "ClockPosition",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"context": {
"$ref": "#/$defs/ArtifactHandle"
},
"target_clock_id": {
"title": "Target Clock Id",
"type": "string"
},
"target_space": {
"enum": [
"source_frame",
"arrangement_qn",
"host_seconds",
"render_frame"
],
"title": "Target Space",
"type": "string"
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/ClockPosition"
},
{
"type": "null"
}
],
"default": null
},
"anchor_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Anchor Id"
},
"occurrence_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Occurrence Id"
}
},
"required": [
"store_root",
"context",
"target_clock_id",
"target_space"
],
"title": "context_resolveArguments",
"type": "object",
"additionalProperties": false
}practice_render Exact original-rate PCM passages and repetitions from declared occurrences; no implicit DSP.
Domain: practice. Read only: false.
Python
pocket_music.practice_audio.practice_render(store_root: 'str', request_id: 'str', context: 'ArtifactHandle', occurrence_ids: 'list[str]') -> 'dict'CLI
pocket practice-render --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"context": {
"$ref": "#/$defs/ArtifactHandle"
},
"occurrence_ids": {
"items": {
"type": "string"
},
"title": "Occurrence Ids",
"type": "array"
}
},
"required": [
"store_root",
"request_id",
"context",
"occurrence_ids"
],
"title": "practice_renderArguments",
"type": "object",
"additionalProperties": false
}practice_compare Bind a baseline and alternatives to a question; measurements and listening remain separate.
Domain: practice. Read only: false.
Python
pocket_music.practice_audio.practice_compare(store_root: 'str', request_id: 'str', baseline: 'ArtifactHandle', variants: 'list[ArtifactHandle]', question: 'str', allow_duration_mismatch: 'bool' = False) -> 'dict'CLI
pocket practice-compare --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"baseline": {
"$ref": "#/$defs/ArtifactHandle"
},
"variants": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Variants",
"type": "array"
},
"question": {
"title": "Question",
"type": "string"
},
"allow_duration_mismatch": {
"default": false,
"title": "Allow Duration Mismatch",
"type": "boolean"
}
},
"required": [
"store_root",
"request_id",
"baseline",
"variants",
"question"
],
"title": "practice_compareArguments",
"type": "object",
"additionalProperties": false
}practice_feedback Attributed, exact-render and interval-bound feedback without inferred listening or preferences.
Domain: practice. Read only: false.
Python
pocket_music.practice_audio.practice_feedback(store_root: 'str', request_id: 'str', comparison: 'ArtifactHandle', render: 'ArtifactHandle', interval_frames: 'list[int]', actor: 'str', actor_kind: "Literal['human', 'agent']", note: 'str', decision: "Literal['keep', 'revise', 'reject', 'no_addition'] | None" = None, preview: 'ArtifactHandle | None' = None) -> 'dict'CLI
pocket practice-feedback --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"comparison": {
"$ref": "#/$defs/ArtifactHandle"
},
"render": {
"$ref": "#/$defs/ArtifactHandle"
},
"interval_frames": {
"items": {
"type": "integer"
},
"title": "Interval Frames",
"type": "array"
},
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"note": {
"title": "Note",
"type": "string"
},
"decision": {
"anyOf": [
{
"enum": [
"keep",
"revise",
"reject",
"no_addition"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Decision"
},
"preview": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"store_root",
"request_id",
"comparison",
"render",
"interval_frames",
"actor",
"actor_kind",
"note"
],
"title": "practice_feedbackArguments",
"type": "object",
"additionalProperties": false
}practice_query Verify retained practice evidence and read bounded render, comparison or feedback records.
Domain: practice. Read only: true.
Python
pocket_music.practice_audio.practice_query(store_root: 'str', artifact: 'ArtifactHandle', section: "Literal['summary', 'mappings']" = 'summary', offset: 'int' = 0, limit: 'int' = 32) -> 'dict'CLI
pocket practice-query --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"artifact": {
"$ref": "#/$defs/ArtifactHandle"
},
"section": {
"default": "summary",
"enum": [
"summary",
"mappings"
],
"title": "Section",
"type": "string"
},
"offset": {
"default": 0,
"title": "Offset",
"type": "integer"
},
"limit": {
"default": 32,
"title": "Limit",
"type": "integer"
}
},
"required": [
"store_root",
"artifact"
],
"title": "practice_queryArguments",
"type": "object",
"additionalProperties": false
}interpretation_create Retain source-bound candidate selections, authored claims or unresolved questions without changing analysis or clocks.
Domain: interpretation. Read only: false.
Python
pocket_music.interpretations.interpretation_create(store_root: 'str', request_id: 'str', context: 'ArtifactHandle', source_clock_id: 'str', claim: 'InterpretationClaim', attribution: 'Attribution', evidence: 'InterpretationEvidence | None' = None) -> 'dict'CLI
pocket interpretation-create --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"Attribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "Attribution",
"type": "object"
},
"InterpretationEvidence": {
"additionalProperties": false,
"properties": {
"hypotheses": {
"$ref": "#/$defs/ArtifactHandle"
},
"expected_revision": {
"title": "Expected Revision",
"type": "string"
},
"annotation_id": {
"title": "Annotation Id",
"type": "string"
}
},
"required": [
"hypotheses",
"expected_revision",
"annotation_id"
],
"title": "InterpretationEvidence",
"type": "object"
},
"PointClaim": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"onset",
"bar_one",
"phrase_start"
],
"title": "Kind",
"type": "string"
},
"status": {
"enum": [
"selected",
"authored"
],
"title": "Status",
"type": "string"
},
"source_frame_q": {
"$ref": "#/$defs/Rational"
}
},
"required": [
"kind",
"status",
"source_frame_q"
],
"title": "PointClaim",
"type": "object"
},
"PulseClaim": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "pulse",
"title": "Kind",
"type": "string"
},
"status": {
"enum": [
"selected",
"authored"
],
"title": "Status",
"type": "string"
},
"bpm": {
"title": "Bpm",
"type": "number"
},
"interval_frames": {
"items": {
"type": "integer"
},
"title": "Interval Frames",
"type": "array"
}
},
"required": [
"kind",
"status",
"bpm",
"interval_frames"
],
"title": "PulseClaim",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
},
"UnresolvedClaim": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"onset",
"pulse",
"bar_one",
"phrase_start"
],
"title": "Kind",
"type": "string"
},
"status": {
"const": "unresolved",
"title": "Status",
"type": "string"
},
"interval_frames": {
"items": {
"type": "integer"
},
"title": "Interval Frames",
"type": "array"
}
},
"required": [
"kind",
"status",
"interval_frames"
],
"title": "UnresolvedClaim",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"context": {
"$ref": "#/$defs/ArtifactHandle"
},
"source_clock_id": {
"title": "Source Clock Id",
"type": "string"
},
"claim": {
"anyOf": [
{
"$ref": "#/$defs/PointClaim"
},
{
"$ref": "#/$defs/PulseClaim"
},
{
"$ref": "#/$defs/UnresolvedClaim"
}
],
"title": "Claim"
},
"attribution": {
"$ref": "#/$defs/Attribution"
},
"evidence": {
"anyOf": [
{
"$ref": "#/$defs/InterpretationEvidence"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"store_root",
"request_id",
"context",
"source_clock_id",
"claim",
"attribution"
],
"title": "interpretation_createArguments",
"type": "object",
"additionalProperties": false
}interpretation_query Revalidate exact evidence and original source coordinates for a musical interpretation.
Domain: interpretation. Read only: true.
Python
pocket_music.interpretations.interpretation_query(store_root: 'str', interpretation: 'ArtifactHandle') -> 'dict'CLI
pocket interpretation-query --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"interpretation": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"store_root",
"interpretation"
],
"title": "interpretation_queryArguments",
"type": "object",
"additionalProperties": false
}context_bind_interpretation Publish an immutable v2 context with a typed selection or exact point anchor; preserve v1 parents.
Domain: context. Read only: false.
Python
pocket_music.interpretations.context_bind_interpretation(store_root: 'str', request_id: 'str', context: 'ArtifactHandle', interpretation: 'ArtifactHandle', binding: 'InterpretationBinding', attribution: 'Attribution') -> 'dict'CLI
pocket context-bind-interpretation --spec <arguments.json>MCP input schema
{
"$defs": {
"AnchorBinding": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "anchor",
"title": "Kind",
"type": "string"
},
"binding_id": {
"title": "Binding Id",
"type": "string"
},
"anchor_id": {
"title": "Anchor Id",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
}
},
"required": [
"kind",
"binding_id",
"anchor_id",
"label"
],
"title": "AnchorBinding",
"type": "object"
},
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"Attribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "Attribution",
"type": "object"
},
"SelectionBinding": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "selection",
"title": "Kind",
"type": "string"
},
"binding_id": {
"title": "Binding Id",
"type": "string"
}
},
"required": [
"kind",
"binding_id"
],
"title": "SelectionBinding",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"context": {
"$ref": "#/$defs/ArtifactHandle"
},
"interpretation": {
"$ref": "#/$defs/ArtifactHandle"
},
"binding": {
"anyOf": [
{
"$ref": "#/$defs/SelectionBinding"
},
{
"$ref": "#/$defs/AnchorBinding"
}
],
"title": "Binding"
},
"attribution": {
"$ref": "#/$defs/Attribution"
}
},
"required": [
"store_root",
"request_id",
"context",
"interpretation",
"binding",
"attribution"
],
"title": "context_bind_interpretationArguments",
"type": "object",
"additionalProperties": false
}context_edit Apply explicit source slips, timeline shifts or anchor rebindings with locks and immutable preservation receipts.
Domain: context. Read only: false.
Python
pocket_music.context_edits.context_edit(store_root: 'str', request_id: 'str', context: 'ArtifactHandle', operations: 'list[ContextEdit]', locks: 'list[ContextLock]', attribution: 'Attribution') -> 'dict'CLI
pocket context-edit --spec <arguments.json>MCP input schema
{
"$defs": {
"AnchorRebind": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "anchor_rebind",
"title": "Kind",
"type": "string"
},
"anchor_id": {
"title": "Anchor Id",
"type": "string"
},
"interpretation": {
"$ref": "#/$defs/ArtifactHandle"
},
"binding_id": {
"title": "Binding Id",
"type": "string"
}
},
"required": [
"kind",
"anchor_id",
"interpretation",
"binding_id"
],
"title": "AnchorRebind",
"type": "object"
},
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"Attribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "Attribution",
"type": "object"
},
"ContextLock": {
"additionalProperties": false,
"properties": {
"section": {
"enum": [
"occurrences",
"anchors"
],
"title": "Section",
"type": "string"
},
"object_id": {
"title": "Object Id",
"type": "string"
},
"fields": {
"items": {
"type": "string"
},
"title": "Fields",
"type": "array"
}
},
"required": [
"section",
"object_id",
"fields"
],
"title": "ContextLock",
"type": "object"
},
"OccurrenceShift": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "occurrence_shift_timeline",
"title": "Kind",
"type": "string"
},
"occurrence_ids": {
"items": {
"type": "string"
},
"title": "Occurrence Ids",
"type": "array"
},
"delta_qn": {
"$ref": "#/$defs/Rational"
}
},
"required": [
"kind",
"occurrence_ids",
"delta_qn"
],
"title": "OccurrenceShift",
"type": "object"
},
"OccurrenceSlip": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "occurrence_slip_source",
"title": "Kind",
"type": "string"
},
"occurrence_ids": {
"items": {
"type": "string"
},
"title": "Occurrence Ids",
"type": "array"
},
"delta_frames": {
"title": "Delta Frames",
"type": "integer"
}
},
"required": [
"kind",
"occurrence_ids",
"delta_frames"
],
"title": "OccurrenceSlip",
"type": "object"
},
"Rational": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "Rational",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"context": {
"$ref": "#/$defs/ArtifactHandle"
},
"operations": {
"items": {
"anyOf": [
{
"$ref": "#/$defs/OccurrenceSlip"
},
{
"$ref": "#/$defs/OccurrenceShift"
},
{
"$ref": "#/$defs/AnchorRebind"
}
]
},
"title": "Operations",
"type": "array"
},
"locks": {
"items": {
"$ref": "#/$defs/ContextLock"
},
"title": "Locks",
"type": "array"
},
"attribution": {
"$ref": "#/$defs/Attribution"
}
},
"required": [
"store_root",
"request_id",
"context",
"operations",
"locks",
"attribution"
],
"title": "context_editArguments",
"type": "object",
"additionalProperties": false
}context_edit_query Revalidate exact parent/child changes, protected fields and declared renderability without rendering audio.
Domain: context. Read only: true.
Python
pocket_music.context_edits.context_edit_query(store_root: 'str', edit: 'ArtifactHandle') -> 'dict'CLI
pocket context-edit-query --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"edit": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"store_root",
"edit"
],
"title": "context_edit_queryArguments",
"type": "object",
"additionalProperties": false
}practice_compare_revisions Compare immutable context edits with their exact baseline, verified edit ancestry and explicit output correspondence.
Domain: practice. Read only: false.
Python
pocket_music.practice_comparisons.practice_compare_revisions(store_root: 'str', request_id: 'str', baseline: 'ArtifactHandle', variants: 'list[ArtifactHandle]', edit_receipts: 'list[ArtifactHandle]', correspondence: 'list[RevisionCorrespondence]', question: 'str', duration_policy: "Literal['equal', 'allow_mismatch']" = 'equal') -> 'dict'CLI
pocket practice-compare-revisions --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"OccurrencePair": {
"additionalProperties": false,
"properties": {
"baseline_occurrence_id": {
"title": "Baseline Occurrence Id",
"type": "string"
},
"variant_occurrence_id": {
"title": "Variant Occurrence Id",
"type": "string"
},
"baseline_interval_frames": {
"items": {
"type": "integer"
},
"title": "Baseline Interval Frames",
"type": "array"
},
"variant_interval_frames": {
"items": {
"type": "integer"
},
"title": "Variant Interval Frames",
"type": "array"
}
},
"required": [
"baseline_occurrence_id",
"variant_occurrence_id",
"baseline_interval_frames",
"variant_interval_frames"
],
"title": "OccurrencePair",
"type": "object"
},
"RevisionCorrespondence": {
"additionalProperties": false,
"properties": {
"variant": {
"$ref": "#/$defs/ArtifactHandle"
},
"pairs": {
"items": {
"$ref": "#/$defs/OccurrencePair"
},
"title": "Pairs",
"type": "array"
}
},
"required": [
"variant",
"pairs"
],
"title": "RevisionCorrespondence",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"baseline": {
"$ref": "#/$defs/ArtifactHandle"
},
"variants": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Variants",
"type": "array"
},
"edit_receipts": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Edit Receipts",
"type": "array"
},
"correspondence": {
"items": {
"$ref": "#/$defs/RevisionCorrespondence"
},
"title": "Correspondence",
"type": "array"
},
"question": {
"title": "Question",
"type": "string"
},
"duration_policy": {
"default": "equal",
"enum": [
"equal",
"allow_mismatch"
],
"title": "Duration Policy",
"type": "string"
}
},
"required": [
"store_root",
"request_id",
"baseline",
"variants",
"edit_receipts",
"correspondence",
"question"
],
"title": "practice_compare_revisionsArguments",
"type": "object",
"additionalProperties": false
}practice_envelope Declared linear fade-out/in at exact occurrence joins; baseline and timing remain unchanged.
Domain: practice. Read only: false.
Python
pocket_music.practice_envelopes.practice_envelope(store_root: 'str', request_id: 'str', render: 'ArtifactHandle', joins: 'list[JoinEnvelope]', attribution: 'Attribution') -> 'dict'CLI
pocket practice-envelope --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"Attribution": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"statement": {
"title": "Statement",
"type": "string"
},
"uncertainty": {
"items": {
"type": "string"
},
"title": "Uncertainty",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"statement",
"uncertainty"
],
"title": "Attribution",
"type": "object"
},
"JoinEnvelope": {
"additionalProperties": false,
"properties": {
"boundary_frame": {
"title": "Boundary Frame",
"type": "integer"
},
"fade_out_frames": {
"title": "Fade Out Frames",
"type": "integer"
},
"fade_in_frames": {
"title": "Fade In Frames",
"type": "integer"
},
"curve": {
"const": "linear",
"title": "Curve",
"type": "string"
}
},
"required": [
"boundary_frame",
"fade_out_frames",
"fade_in_frames",
"curve"
],
"title": "JoinEnvelope",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"render": {
"$ref": "#/$defs/ArtifactHandle"
},
"joins": {
"items": {
"$ref": "#/$defs/JoinEnvelope"
},
"title": "Joins",
"type": "array"
},
"attribution": {
"$ref": "#/$defs/Attribution"
}
},
"required": [
"store_root",
"request_id",
"render",
"joins",
"attribution"
],
"title": "practice_envelopeArguments",
"type": "object",
"additionalProperties": false
}practice_compare_processed Compare explicit join derivatives with their exact unchanged baseline; no inferred listening verdict.
Domain: practice. Read only: false.
Python
pocket_music.practice_envelopes.practice_compare_processed(store_root: 'str', request_id: 'str', baseline: 'ArtifactHandle', variants: 'list[ArtifactHandle]', question: 'str') -> 'dict'CLI
pocket practice-compare-processed --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"baseline": {
"$ref": "#/$defs/ArtifactHandle"
},
"variants": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Variants",
"type": "array"
},
"question": {
"title": "Question",
"type": "string"
}
},
"required": [
"store_root",
"request_id",
"baseline",
"variants",
"question"
],
"title": "practice_compare_processedArguments",
"type": "object",
"additionalProperties": false
}practice_feedback_query Retrieve explicit attributed reports by exact render, interval, actor and decision, preserving contradictions.
Domain: practice. Read only: true.
Python
pocket_music.practice_feedback_query.practice_feedback_query(store_root: 'str', feedback: 'list[ArtifactHandle]', render: 'ArtifactHandle | None' = None, actor: 'str | None' = None, actor_kind: "Literal['human', 'agent'] | None" = None, decision: "Literal['keep', 'revise', 'reject', 'no_addition'] | None" = None, interval_frames: 'list[int] | None' = None, limit: 'int' = 16, cursor: 'str | None' = None, max_bytes: 'int' = 16384) -> 'dict'CLI
pocket practice-feedback-query --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"feedback": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Feedback",
"type": "array"
},
"render": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"actor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Actor"
},
"actor_kind": {
"anyOf": [
{
"enum": [
"human",
"agent"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Actor Kind"
},
"decision": {
"anyOf": [
{
"enum": [
"keep",
"revise",
"reject",
"no_addition"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Decision"
},
"interval_frames": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Interval Frames"
},
"limit": {
"default": 16,
"title": "Limit",
"type": "integer"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cursor"
},
"max_bytes": {
"default": 16384,
"title": "Max Bytes",
"type": "integer"
}
},
"required": [
"store_root",
"feedback"
],
"title": "practice_feedback_queryArguments",
"type": "object",
"additionalProperties": false
}practice_preview Declared original-rate PCM16 browser preview of an exact render; nearest-even rounding, no dither or other DSP, unrepresentable samples refused.
Domain: practice. Read only: false.
Python
pocket_music.practice_previews.practice_preview(store_root: 'str', request_id: 'str', render: 'ArtifactHandle', profile: "Literal['browser-pcm16-original-rate/v1']") -> 'dict'CLI
pocket practice-preview --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"render": {
"$ref": "#/$defs/ArtifactHandle"
},
"profile": {
"const": "browser-pcm16-original-rate/v1",
"title": "Profile",
"type": "string"
}
},
"required": [
"store_root",
"request_id",
"render",
"profile"
],
"title": "practice_previewArguments",
"type": "object",
"additionalProperties": false
}instrument_inspect Bounded installation and attributed state inspection.
Domain: instrument. Read only: false.
Python
pocket_music.instruments.core.instrument_inspect(*, store_root: 'str', request_id: 'str', scope: "Literal['installed', 'supplied_observation']" = 'installed', plugin_roots: 'list[str] | None' = None, product: 'str' = 'all', observation: 'InstrumentObservation | None' = None, limit: 'int' = 50, offset: 'int' = 0) -> 'dict'CLI
pocket instrument-inspect --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"InstrumentIdentity": {
"additionalProperties": false,
"properties": {
"manufacturer": {
"title": "Manufacturer",
"type": "string"
},
"product": {
"title": "Product",
"type": "string"
},
"build": {
"title": "Build",
"type": "string"
},
"format": {
"enum": [
"VST3",
"AU",
"AAX",
"VST2",
"native",
"unknown"
],
"title": "Format",
"type": "string"
},
"class_id": {
"title": "Class Id",
"type": "string"
},
"instance_id": {
"title": "Instance Id",
"type": "string"
},
"host_build": {
"title": "Host Build",
"type": "string"
},
"os_arch": {
"title": "Os Arch",
"type": "string"
},
"binding": {
"title": "Binding",
"type": "string"
}
},
"required": [
"manufacturer",
"product",
"build",
"format",
"class_id",
"instance_id",
"host_build",
"os_arch",
"binding"
],
"title": "InstrumentIdentity",
"type": "object"
},
"InstrumentObservation": {
"additionalProperties": false,
"properties": {
"identity": {
"$ref": "#/$defs/InstrumentIdentity"
},
"topology_token": {
"title": "Topology Token",
"type": "string"
},
"parameters": {
"items": {
"$ref": "#/$defs/ParameterDescriptor"
},
"title": "Parameters",
"type": "array"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"observed_at": {
"title": "Observed At",
"type": "string"
},
"source_kind": {
"enum": [
"saved",
"live",
"manual"
],
"title": "Source Kind",
"type": "string"
},
"opaque_state": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"dependencies": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Dependencies",
"type": "array"
}
},
"required": [
"identity",
"topology_token",
"parameters",
"attribution",
"observed_at",
"source_kind"
],
"title": "InstrumentObservation",
"type": "object"
},
"ParameterDescriptor": {
"additionalProperties": false,
"properties": {
"parameter_id": {
"title": "Parameter Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"identity_quality": {
"enum": [
"native_id",
"host_slot_bound"
],
"title": "Identity Quality",
"type": "string"
},
"native_min": {
"title": "Native Min",
"type": "number"
},
"native_max": {
"title": "Native Max",
"type": "number"
},
"value": {
"title": "Value",
"type": "number"
},
"unit": {
"title": "Unit",
"type": "string"
},
"quantized": {
"title": "Quantized",
"type": "boolean"
},
"values": {
"items": {
"type": "number"
},
"title": "Values",
"type": "array"
},
"writable": {
"title": "Writable",
"type": "boolean"
},
"automation_owner": {
"enum": [
"none",
"host_automation",
"macro",
"remote",
"unknown"
],
"title": "Automation Owner",
"type": "string"
},
"semantic_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Semantic Key"
},
"mapping_evidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Mapping Evidence"
},
"display_value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Display Value"
}
},
"required": [
"parameter_id",
"name",
"identity_quality",
"native_min",
"native_max",
"value",
"unit",
"quantized",
"values",
"writable",
"automation_owner",
"semantic_key",
"mapping_evidence"
],
"title": "ParameterDescriptor",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"scope": {
"default": "installed",
"enum": [
"installed",
"supplied_observation"
],
"title": "Scope",
"type": "string"
},
"plugin_roots": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Plugin Roots"
},
"product": {
"default": "all",
"title": "Product",
"type": "string"
},
"observation": {
"anyOf": [
{
"$ref": "#/$defs/InstrumentObservation"
},
{
"type": "null"
}
],
"default": null
},
"limit": {
"default": 50,
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"title": "Offset",
"type": "integer"
}
},
"required": [
"store_root",
"request_id"
],
"title": "instrument_inspectArguments",
"type": "object",
"additionalProperties": false
}instrument_parameters Query captured exposed descriptors without loading a patch.
Domain: instrument. Read only: true.
Python
pocket_music.instruments.core.instrument_parameters(*, store_root: 'str', state: 'ArtifactHandle', limit: 'int' = 50, offset: 'int' = 0) -> 'dict'CLI
pocket instrument-parameters --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"state": {
"$ref": "#/$defs/ArtifactHandle"
},
"limit": {
"default": 50,
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"title": "Offset",
"type": "integer"
}
},
"required": [
"store_root",
"state"
],
"title": "instrument_parametersArguments",
"type": "object",
"additionalProperties": false
}preset_catalog Hash and query opaque local presets without loading them.
Domain: instrument. Read only: false.
Python
pocket_music.instruments.core.preset_catalog(*, store_root: 'str', operation: "Literal['scan', 'query']", roots: 'list[str] | None' = None, catalog: 'ArtifactHandle | None' = None, product: 'str' = 'all', query: 'str' = '', limit: 'int' = 50, offset: 'int' = 0, request_id: 'str | None' = None) -> 'dict'CLI
pocket preset-catalog --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"operation": {
"enum": [
"scan",
"query"
],
"title": "Operation",
"type": "string"
},
"roots": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Roots"
},
"catalog": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"product": {
"default": "all",
"title": "Product",
"type": "string"
},
"query": {
"default": "",
"title": "Query",
"type": "string"
},
"limit": {
"default": 50,
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"title": "Offset",
"type": "integer"
},
"request_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Request Id"
}
},
"required": [
"store_root",
"operation"
],
"title": "preset_catalogArguments",
"type": "object",
"additionalProperties": false
}sound_plan Bounded sound alternatives requiring no MIDI or DAW.
Domain: instrument. Read only: false.
Python
pocket_music.instruments.core.sound_plan(*, store_root: 'str', request_id: 'str', brief: 'str', recipe: "Literal['operator_sine_pluck', 'parameter_alternatives']" = 'operator_sine_pluck', state: 'ArtifactHandle | None' = None, alternatives: 'list[SoundAlternative] | None' = None, expected_layout_sha256: 'str | None' = None, expected_topology_token: 'str | None' = None, locks: 'list[str] | None' = None, context: 'ArtifactHandle | None' = None, performance: 'ArtifactHandle | None' = None, max_alternatives: 'int' = 3) -> 'dict'CLI
pocket sound-plan --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ParameterChange": {
"additionalProperties": false,
"properties": {
"parameter_id": {
"title": "Parameter Id",
"type": "string"
},
"value": {
"title": "Value",
"type": "number"
}
},
"required": [
"parameter_id",
"value"
],
"title": "ParameterChange",
"type": "object"
},
"SoundAlternative": {
"additionalProperties": false,
"properties": {
"label": {
"title": "Label",
"type": "string"
},
"hypothesis": {
"title": "Hypothesis",
"type": "string"
},
"changes": {
"items": {
"$ref": "#/$defs/ParameterChange"
},
"title": "Changes",
"type": "array"
}
},
"required": [
"label",
"hypothesis",
"changes"
],
"title": "SoundAlternative",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"brief": {
"title": "Brief",
"type": "string"
},
"recipe": {
"default": "operator_sine_pluck",
"enum": [
"operator_sine_pluck",
"parameter_alternatives"
],
"title": "Recipe",
"type": "string"
},
"state": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"alternatives": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/SoundAlternative"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Alternatives"
},
"expected_layout_sha256": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Expected Layout Sha256"
},
"expected_topology_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Expected Topology Token"
},
"locks": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Locks"
},
"context": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"performance": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"max_alternatives": {
"default": 3,
"title": "Max Alternatives",
"type": "integer"
}
},
"required": [
"store_root",
"request_id",
"brief"
],
"title": "sound_planArguments",
"type": "object",
"additionalProperties": false
}serum_inspect Serum product/build/format inventory and attributed state; native verification remains separate.
Domain: serum. Read only: false.
Python
pocket_music.instruments.serum.serum_inspect(*, store_root: 'str', request_id: 'str', scope: "Literal['installed', 'supplied_observation']" = 'installed', product: "Literal['serum1', 'serum2', 'serum_fx1', 'serum_fx2']" = 'serum2', plugin_roots: 'list[str] | None' = None, observation: 'InstrumentObservation | None' = None, limit: 'int' = 50, offset: 'int' = 0) -> 'dict'CLI
pocket serum-inspect --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"InstrumentIdentity": {
"additionalProperties": false,
"properties": {
"manufacturer": {
"title": "Manufacturer",
"type": "string"
},
"product": {
"title": "Product",
"type": "string"
},
"build": {
"title": "Build",
"type": "string"
},
"format": {
"enum": [
"VST3",
"AU",
"AAX",
"VST2",
"native",
"unknown"
],
"title": "Format",
"type": "string"
},
"class_id": {
"title": "Class Id",
"type": "string"
},
"instance_id": {
"title": "Instance Id",
"type": "string"
},
"host_build": {
"title": "Host Build",
"type": "string"
},
"os_arch": {
"title": "Os Arch",
"type": "string"
},
"binding": {
"title": "Binding",
"type": "string"
}
},
"required": [
"manufacturer",
"product",
"build",
"format",
"class_id",
"instance_id",
"host_build",
"os_arch",
"binding"
],
"title": "InstrumentIdentity",
"type": "object"
},
"InstrumentObservation": {
"additionalProperties": false,
"properties": {
"identity": {
"$ref": "#/$defs/InstrumentIdentity"
},
"topology_token": {
"title": "Topology Token",
"type": "string"
},
"parameters": {
"items": {
"$ref": "#/$defs/ParameterDescriptor"
},
"title": "Parameters",
"type": "array"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"observed_at": {
"title": "Observed At",
"type": "string"
},
"source_kind": {
"enum": [
"saved",
"live",
"manual"
],
"title": "Source Kind",
"type": "string"
},
"opaque_state": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
]
},
"dependencies": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Dependencies",
"type": "array"
}
},
"required": [
"identity",
"topology_token",
"parameters",
"attribution",
"observed_at",
"source_kind"
],
"title": "InstrumentObservation",
"type": "object"
},
"ParameterDescriptor": {
"additionalProperties": false,
"properties": {
"parameter_id": {
"title": "Parameter Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"identity_quality": {
"enum": [
"native_id",
"host_slot_bound"
],
"title": "Identity Quality",
"type": "string"
},
"native_min": {
"title": "Native Min",
"type": "number"
},
"native_max": {
"title": "Native Max",
"type": "number"
},
"value": {
"title": "Value",
"type": "number"
},
"unit": {
"title": "Unit",
"type": "string"
},
"quantized": {
"title": "Quantized",
"type": "boolean"
},
"values": {
"items": {
"type": "number"
},
"title": "Values",
"type": "array"
},
"writable": {
"title": "Writable",
"type": "boolean"
},
"automation_owner": {
"enum": [
"none",
"host_automation",
"macro",
"remote",
"unknown"
],
"title": "Automation Owner",
"type": "string"
},
"semantic_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Semantic Key"
},
"mapping_evidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Mapping Evidence"
},
"display_value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Display Value"
}
},
"required": [
"parameter_id",
"name",
"identity_quality",
"native_min",
"native_max",
"value",
"unit",
"quantized",
"values",
"writable",
"automation_owner",
"semantic_key",
"mapping_evidence"
],
"title": "ParameterDescriptor",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"scope": {
"default": "installed",
"enum": [
"installed",
"supplied_observation"
],
"title": "Scope",
"type": "string"
},
"product": {
"default": "serum2",
"enum": [
"serum1",
"serum2",
"serum_fx1",
"serum_fx2"
],
"title": "Product",
"type": "string"
},
"plugin_roots": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Plugin Roots"
},
"observation": {
"anyOf": [
{
"$ref": "#/$defs/InstrumentObservation"
},
{
"type": "null"
}
],
"default": null
},
"limit": {
"default": 50,
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"title": "Offset",
"type": "integer"
}
},
"required": [
"store_root",
"request_id"
],
"title": "serum_inspectArguments",
"type": "object",
"additionalProperties": false
}serum_presets Opaque Serum catalog; extensions alone do not prove compatibility.
Domain: serum. Read only: false.
Python
pocket_music.instruments.serum.serum_presets(*, store_root: 'str', operation: "Literal['scan', 'query']", roots: 'list[str] | None' = None, catalog: 'ArtifactHandle | None' = None, product: "Literal['serum1', 'serum2']" = 'serum2', query: 'str' = '', limit: 'int' = 50, offset: 'int' = 0, request_id: 'str | None' = None) -> 'dict'CLI
pocket serum-presets --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"operation": {
"enum": [
"scan",
"query"
],
"title": "Operation",
"type": "string"
},
"roots": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Roots"
},
"catalog": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"product": {
"default": "serum2",
"enum": [
"serum1",
"serum2"
],
"title": "Product",
"type": "string"
},
"query": {
"default": "",
"title": "Query",
"type": "string"
},
"limit": {
"default": 50,
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"title": "Offset",
"type": "integer"
},
"request_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Request Id"
}
},
"required": [
"store_root",
"operation"
],
"title": "serum_presetsArguments",
"type": "object",
"additionalProperties": false
}serum_plan Serum-specific planning with unavailable routes declared.
Domain: serum. Read only: false.
Python
pocket_music.instruments.serum.serum_plan(*, store_root: 'str', request_id: 'str', brief: 'str', state: 'ArtifactHandle', alternatives: 'list[SoundAlternative]', expected_layout_sha256: 'str', expected_topology_token: 'str', locks: 'list[str] | None' = None, context: 'ArtifactHandle | None' = None, performance: 'ArtifactHandle | None' = None, max_alternatives: 'int' = 3) -> 'dict'CLI
pocket serum-plan --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"ParameterChange": {
"additionalProperties": false,
"properties": {
"parameter_id": {
"title": "Parameter Id",
"type": "string"
},
"value": {
"title": "Value",
"type": "number"
}
},
"required": [
"parameter_id",
"value"
],
"title": "ParameterChange",
"type": "object"
},
"SoundAlternative": {
"additionalProperties": false,
"properties": {
"label": {
"title": "Label",
"type": "string"
},
"hypothesis": {
"title": "Hypothesis",
"type": "string"
},
"changes": {
"items": {
"$ref": "#/$defs/ParameterChange"
},
"title": "Changes",
"type": "array"
}
},
"required": [
"label",
"hypothesis",
"changes"
],
"title": "SoundAlternative",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"brief": {
"title": "Brief",
"type": "string"
},
"state": {
"$ref": "#/$defs/ArtifactHandle"
},
"alternatives": {
"items": {
"$ref": "#/$defs/SoundAlternative"
},
"title": "Alternatives",
"type": "array"
},
"expected_layout_sha256": {
"title": "Expected Layout Sha256",
"type": "string"
},
"expected_topology_token": {
"title": "Expected Topology Token",
"type": "string"
},
"locks": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Locks"
},
"context": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"performance": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"max_alternatives": {
"default": 3,
"title": "Max Alternatives",
"type": "integer"
}
},
"required": [
"store_root",
"request_id",
"brief",
"state",
"alternatives",
"expected_layout_sha256",
"expected_topology_token"
],
"title": "serum_planArguments",
"type": "object",
"additionalProperties": false
}build_native_midi_device Build the separate read-only Max device without running a host.
Domain: native. Read only: false.
Python
pocket_music.native_midi.build_native_midi_device(output_dir: 'str', store_root: 'str', request_id: 'str') -> 'dict'CLI
pocket build-native-midi-device --spec <arguments.json>MCP input schema
{
"properties": {
"output_dir": {
"title": "Output Dir",
"type": "string"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"output_dir",
"store_root",
"request_id"
],
"title": "build_native_midi_deviceArguments",
"type": "object",
"additionalProperties": false
}build_native_midi_writer Build the separate guarded writer package; building does not authorize or execute edits.
Domain: native. Read only: false.
Python
pocket_music.native_midi.build_native_midi_writer(output_dir: 'str', store_root: 'str', request_id: 'str') -> 'dict'CLI
pocket build-native-midi-writer --spec <arguments.json>MCP input schema
{
"properties": {
"output_dir": {
"title": "Output Dir",
"type": "string"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"output_dir",
"store_root",
"request_id"
],
"title": "build_native_midi_writerArguments",
"type": "object",
"additionalProperties": false
}native_midi_read Bounded native notes with explicit target, retained evidence and optional saved binding.
Domain: native. Read only: false.
Python
pocket_music.native_midi.native_midi_read(store_root: 'str', request_id: 'str', target: 'NativeReadTarget | None' = None, saved_binding: 'NativeSavedBinding | None' = None, expected_session_nonce: 'str | None' = None, bridge_dir: 'str | None' = None, timeout_seconds: 'float' = 15, limit: 'int' = 64, offset: 'int' = 0, byte_budget: 'int' = 16384, observation: 'ArtifactHandle | None' = None) -> 'dict'CLI
pocket native-midi-read --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"NativeReadTarget": {
"additionalProperties": false,
"properties": {
"location": {
"const": "arrangement",
"title": "Location",
"type": "string"
},
"track_index": {
"title": "Track Index",
"type": "integer"
},
"clip_index": {
"title": "Clip Index",
"type": "integer"
}
},
"required": [
"location",
"track_index",
"clip_index"
],
"title": "NativeReadTarget",
"type": "object"
},
"NativeSavedBinding": {
"additionalProperties": false,
"properties": {
"saved_als": {
"title": "Saved Als",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"track_id": {
"title": "Track Id",
"type": "string"
},
"clip_id": {
"title": "Clip Id",
"type": "string"
}
},
"required": [
"saved_als",
"expected_sha256",
"track_id",
"clip_id"
],
"title": "NativeSavedBinding",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"target": {
"anyOf": [
{
"$ref": "#/$defs/NativeReadTarget"
},
{
"type": "null"
}
],
"default": null
},
"saved_binding": {
"anyOf": [
{
"$ref": "#/$defs/NativeSavedBinding"
},
{
"type": "null"
}
],
"default": null
},
"expected_session_nonce": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Expected Session Nonce"
},
"bridge_dir": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Bridge Dir"
},
"timeout_seconds": {
"default": 15,
"title": "Timeout Seconds",
"type": "number"
},
"limit": {
"default": 64,
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"title": "Offset",
"type": "integer"
},
"byte_budget": {
"default": 16384,
"title": "Byte Budget",
"type": "integer"
},
"observation": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"store_root",
"request_id"
],
"title": "native_midi_readArguments",
"type": "object",
"additionalProperties": false
}native_midi_status Inspect a native request journal without dispatching or implying current state.
Domain: native. Read only: false.
Python
pocket_music.native_midi.native_midi_status(store_root: 'str', request_id: 'str', native_request: 'NativeRequestReference', bridge_dir: 'str | None' = None) -> 'dict'CLI
pocket native-midi-status --spec <arguments.json>MCP input schema
{
"$defs": {
"NativeRequestReference": {
"additionalProperties": false,
"properties": {
"session_nonce": {
"title": "Session Nonce",
"type": "string"
},
"request_key": {
"title": "Request Key",
"type": "string"
}
},
"required": [
"session_nonce",
"request_key"
],
"title": "NativeRequestReference",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"native_request": {
"$ref": "#/$defs/NativeRequestReference"
},
"bridge_dir": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Bridge Dir"
}
},
"required": [
"store_root",
"request_id",
"native_request"
],
"title": "native_midi_statusArguments",
"type": "object",
"additionalProperties": false
}native_midi_write Insert up to three ordinary notes or change one proven note velocity in a supervised isolated stock fixture.
Domain: native. Read only: false.
Python
pocket_music.native_midi.native_midi_write(store_root: 'str', request_id: 'str', workspace_id: 'str', expected_revision: 'int', saved_als: 'str', expected_sha256: 'str', expected_observation: 'ArtifactHandle', writer_device: 'ArtifactHandle', edit: 'NativeMidiWriteEdit', supervision: 'NativeSessionAcknowledgment', bridge_dir: 'str | None' = None, timeout_seconds: 'float' = 15) -> 'dict'CLI
pocket native-midi-write --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"NativeInsertEdit": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "insert_empty",
"title": "Kind",
"type": "string"
},
"notes": {
"items": {
"$ref": "#/$defs/NativeInsertNote"
},
"title": "Notes",
"type": "array"
}
},
"required": [
"kind",
"notes"
],
"title": "NativeInsertEdit",
"type": "object"
},
"NativeInsertNote": {
"additionalProperties": false,
"properties": {
"pitch": {
"title": "Pitch",
"type": "integer"
},
"onset_qn": {
"$ref": "#/$defs/NativeTime"
},
"duration_qn": {
"$ref": "#/$defs/NativeTime"
},
"velocity": {
"title": "Velocity",
"type": "integer"
},
"release_velocity": {
"title": "Release Velocity",
"type": "integer"
}
},
"required": [
"pitch",
"onset_qn",
"duration_qn",
"velocity",
"release_velocity"
],
"title": "NativeInsertNote",
"type": "object"
},
"NativeSessionAcknowledgment": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"observed_at": {
"title": "Observed At",
"type": "string"
},
"exclusive_native_session": {
"const": true,
"title": "Exclusive Native Session",
"type": "boolean"
},
"no_ui_edits_after_native_read": {
"const": true,
"title": "No Ui Edits After Native Read",
"type": "boolean"
},
"note": {
"title": "Note",
"type": "string"
}
},
"required": [
"actor",
"actor_kind",
"observed_at",
"exclusive_native_session",
"no_ui_edits_after_native_read"
],
"title": "NativeSessionAcknowledgment",
"type": "object"
},
"NativeTime": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "NativeTime",
"type": "object"
},
"NativeVelocityEdit": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "set_velocity",
"title": "Kind",
"type": "string"
},
"note_id": {
"title": "Note Id",
"type": "integer"
},
"velocity": {
"title": "Velocity",
"type": "integer"
},
"insertion_terminal": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"kind",
"note_id",
"velocity",
"insertion_terminal"
],
"title": "NativeVelocityEdit",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"workspace_id": {
"title": "Workspace Id",
"type": "string"
},
"expected_revision": {
"title": "Expected Revision",
"type": "integer"
},
"saved_als": {
"title": "Saved Als",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"expected_observation": {
"$ref": "#/$defs/ArtifactHandle"
},
"writer_device": {
"$ref": "#/$defs/ArtifactHandle"
},
"edit": {
"anyOf": [
{
"$ref": "#/$defs/NativeInsertEdit"
},
{
"$ref": "#/$defs/NativeVelocityEdit"
}
],
"title": "Edit"
},
"supervision": {
"$ref": "#/$defs/NativeSessionAcknowledgment"
},
"bridge_dir": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Bridge Dir"
},
"timeout_seconds": {
"default": 15,
"title": "Timeout Seconds",
"type": "number"
}
},
"required": [
"store_root",
"request_id",
"workspace_id",
"expected_revision",
"saved_als",
"expected_sha256",
"expected_observation",
"writer_device",
"edit",
"supervision"
],
"title": "native_midi_writeArguments",
"type": "object",
"additionalProperties": false
}candidate_prepare Copy protected parent and dependencies into an isolated workspace.
Domain: candidate. Read only: false.
Python
pocket_music.native_candidates.candidate_prepare(source_als: 'str', expected_source_sha256: 'str', store_root: 'str', request_id: 'str', mode: "Literal['clone_only', 'with_material']" = 'clone_only', material: 'ArtifactHandle | None' = None, context: 'CandidateContext | None' = None, layer: 'LayerSpec | None' = None) -> 'dict'CLI
pocket candidate-prepare --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"CandidateContext": {
"additionalProperties": false,
"properties": {
"arrangement_start_qn": {
"$ref": "#/$defs/CandidateTime"
},
"length_qn": {
"$ref": "#/$defs/CandidateTime"
},
"tempo_bpm": {
"title": "Tempo Bpm",
"type": "number"
},
"meter": {
"items": {
"type": "integer"
},
"title": "Meter",
"type": "array"
}
},
"required": [
"arrangement_start_qn",
"length_qn",
"tempo_bpm",
"meter"
],
"title": "CandidateContext",
"type": "object"
},
"CandidateTime": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "CandidateTime",
"type": "object"
},
"LayerSpec": {
"additionalProperties": false,
"properties": {
"track_name": {
"title": "Track Name",
"type": "string"
},
"instrument_device": {
"const": "Operator",
"title": "Instrument Device",
"type": "string"
}
},
"required": [
"track_name",
"instrument_device"
],
"title": "LayerSpec",
"type": "object"
}
},
"properties": {
"source_als": {
"title": "Source Als",
"type": "string"
},
"expected_source_sha256": {
"title": "Expected Source Sha256",
"type": "string"
},
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"mode": {
"default": "clone_only",
"enum": [
"clone_only",
"with_material"
],
"title": "Mode",
"type": "string"
},
"material": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"context": {
"anyOf": [
{
"$ref": "#/$defs/CandidateContext"
},
{
"type": "null"
}
],
"default": null
},
"layer": {
"anyOf": [
{
"$ref": "#/$defs/LayerSpec"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"source_als",
"expected_source_sha256",
"store_root",
"request_id"
],
"title": "candidate_prepareArguments",
"type": "object",
"additionalProperties": false
}candidate_inspect Inspect revision-bound workspace and source integrity.
Domain: candidate. Read only: true.
Python
pocket_music.native_candidates.candidate_inspect(store_root: 'str', workspace_id: 'str', expected_revision: 'int', history_limit: 'int' = 0, history_cursor: 'str | None' = None) -> 'dict'CLI
pocket candidate-inspect --spec <arguments.json>MCP input schema
{
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"workspace_id": {
"title": "Workspace Id",
"type": "string"
},
"expected_revision": {
"title": "Expected Revision",
"type": "integer"
},
"history_limit": {
"default": 0,
"title": "History Limit",
"type": "integer"
},
"history_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "History Cursor"
}
},
"required": [
"store_root",
"workspace_id",
"expected_revision"
],
"title": "candidate_inspectArguments",
"type": "object",
"additionalProperties": false
}candidate_cancel Cancel an isolated workspace without deleting its evidence.
Domain: candidate. Read only: false.
Python
pocket_music.native_candidates.candidate_cancel(store_root: 'str', workspace_id: 'str', expected_revision: 'int', request_id: 'str') -> 'dict'CLI
pocket candidate-cancel --spec <arguments.json>MCP input schema
{
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"workspace_id": {
"title": "Workspace Id",
"type": "string"
},
"expected_revision": {
"title": "Expected Revision",
"type": "integer"
},
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"store_root",
"workspace_id",
"expected_revision",
"request_id"
],
"title": "candidate_cancelArguments",
"type": "object",
"additionalProperties": false
}candidate_native_abandon Permanently abandon an unknown native attempt after explicit supervised closure and fresh evidence.
Domain: candidate. Read only: false.
Python
pocket_music.native_candidates.candidate_native_abandon(store_root: 'str', workspace_id: 'str', expected_revision: 'int', pending: 'ArtifactHandle', fresh_observation: 'ArtifactHandle', attribution: 'NativeAbandonment', request_id: 'str', bridge_dir: 'str | None' = None) -> 'dict'CLI
pocket candidate-native-abandon --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"NativeAbandonment": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"observed_at": {
"title": "Observed At",
"type": "string"
},
"reason": {
"title": "Reason",
"type": "string"
},
"all_old_live_max_instances_stopped": {
"const": true,
"title": "All Old Live Max Instances Stopped",
"type": "boolean"
},
"old_writer_unloaded": {
"const": true,
"title": "Old Writer Unloaded",
"type": "boolean"
},
"old_candidate_closed_without_saving": {
"const": true,
"title": "Old Candidate Closed Without Saving",
"type": "boolean"
},
"no_native_dispatch_in_flight": {
"const": true,
"title": "No Native Dispatch In Flight",
"type": "boolean"
}
},
"required": [
"actor",
"actor_kind",
"observed_at",
"reason",
"all_old_live_max_instances_stopped",
"old_writer_unloaded",
"old_candidate_closed_without_saving",
"no_native_dispatch_in_flight"
],
"title": "NativeAbandonment",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"workspace_id": {
"title": "Workspace Id",
"type": "string"
},
"expected_revision": {
"title": "Expected Revision",
"type": "integer"
},
"pending": {
"$ref": "#/$defs/ArtifactHandle"
},
"fresh_observation": {
"$ref": "#/$defs/ArtifactHandle"
},
"attribution": {
"$ref": "#/$defs/NativeAbandonment"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"bridge_dir": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Bridge Dir"
}
},
"required": [
"store_root",
"workspace_id",
"expected_revision",
"pending",
"fresh_observation",
"attribution",
"request_id"
],
"title": "candidate_native_abandonArguments",
"type": "object",
"additionalProperties": false
}candidate_native_reconcile Reconcile a validated terminal with its exact pending workspace and release only its matching lease; never redispatch.
Domain: candidate. Read only: false.
Python
pocket_music.native_candidates.candidate_native_reconcile(store_root: 'str', workspace_id: 'str', expected_revision: 'int', terminal: 'ArtifactHandle', attribution: 'NativeReconciliation', request_id: 'str') -> 'dict'CLI
pocket candidate-native-reconcile --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"NativeReconciliation": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"observed_at": {
"title": "Observed At",
"type": "string"
},
"reason": {
"title": "Reason",
"type": "string"
}
},
"required": [
"actor",
"actor_kind",
"observed_at",
"reason"
],
"title": "NativeReconciliation",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"workspace_id": {
"title": "Workspace Id",
"type": "string"
},
"expected_revision": {
"title": "Expected Revision",
"type": "integer"
},
"terminal": {
"$ref": "#/$defs/ArtifactHandle"
},
"attribution": {
"$ref": "#/$defs/NativeReconciliation"
},
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"store_root",
"workspace_id",
"expected_revision",
"terminal",
"attribution",
"request_id"
],
"title": "candidate_native_reconcileArguments",
"type": "object",
"additionalProperties": false
}candidate_seal Verify source preservation and attributed native save/reopen evidence.
Domain: candidate. Read only: false.
Python
pocket_music.native_candidates.candidate_seal(store_root: 'str', workspace_id: 'str', expected_revision: 'int', saved_als: 'str', expected_sha256: 'str', native_report: 'NativeSaveReport', request_id: 'str', instrument_state: 'ArtifactHandle | None' = None, final_material: 'ArtifactHandle | None' = None, runtime_identity_observation: 'ArtifactHandle | None' = None) -> 'dict'CLI
pocket candidate-seal --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"NativeSaveReport": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"observed_at": {
"title": "Observed At",
"type": "string"
},
"host_version": {
"title": "Host Version",
"type": "string"
},
"saved_als_sha256": {
"title": "Saved Als Sha256",
"type": "string"
},
"saved": {
"title": "Saved",
"type": "boolean"
},
"reopened": {
"title": "Reopened",
"type": "boolean"
},
"missing_media": {
"title": "Missing Media",
"type": "boolean"
},
"device_missing": {
"title": "Device Missing",
"type": "boolean"
},
"instrument_recipe_verified": {
"title": "Instrument Recipe Verified",
"type": "boolean"
},
"evidence": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Evidence",
"type": "array"
}
},
"required": [
"actor",
"actor_kind",
"observed_at",
"host_version",
"saved_als_sha256",
"saved",
"reopened",
"missing_media",
"device_missing"
],
"title": "NativeSaveReport",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"workspace_id": {
"title": "Workspace Id",
"type": "string"
},
"expected_revision": {
"title": "Expected Revision",
"type": "integer"
},
"saved_als": {
"title": "Saved Als",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"native_report": {
"$ref": "#/$defs/NativeSaveReport"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"instrument_state": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"final_material": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
},
"runtime_identity_observation": {
"anyOf": [
{
"$ref": "#/$defs/ArtifactHandle"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"store_root",
"workspace_id",
"expected_revision",
"saved_als",
"expected_sha256",
"native_report",
"request_id"
],
"title": "candidate_sealArguments",
"type": "object",
"additionalProperties": false
}validate_candidate Recheck sealed v3 identities and preservation evidence.
Domain: candidate. Read only: true.
Python
pocket_music.native_candidates.validate_candidate(candidate: 'ArtifactHandle', store_root: 'str') -> 'dict'CLI
pocket validate-candidate --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"candidate": {
"$ref": "#/$defs/ArtifactHandle"
},
"store_root": {
"title": "Store Root",
"type": "string"
}
},
"required": [
"candidate",
"store_root"
],
"title": "validate_candidateArguments",
"type": "object",
"additionalProperties": false
}audition_plan Bind candidates and an unchanged baseline to explicit render settings.
Domain: audition. Read only: false.
Python
pocket_music.auditions.audition_plan(store_root: 'str', request_id: 'str', candidates: 'list[ArtifactHandle]', baseline: 'ArtifactHandle', span_qn: 'list[CandidateTime]', question: 'str', pre_roll_qn: 'CandidateTime | None' = None, post_roll_qn: 'CandidateTime | None' = None, tail_seconds: 'float' = 4, sample_rate: 'int' = 48000, channels: 'int' = 2, signal_expectation: 'str' = 'audible') -> 'dict'CLI
pocket audition-plan --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"CandidateTime": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "CandidateTime",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"candidates": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Candidates",
"type": "array"
},
"baseline": {
"$ref": "#/$defs/ArtifactHandle"
},
"span_qn": {
"items": {
"$ref": "#/$defs/CandidateTime"
},
"title": "Span Qn",
"type": "array"
},
"question": {
"title": "Question",
"type": "string"
},
"pre_roll_qn": {
"anyOf": [
{
"$ref": "#/$defs/CandidateTime"
},
{
"type": "null"
}
],
"default": null
},
"post_roll_qn": {
"anyOf": [
{
"$ref": "#/$defs/CandidateTime"
},
{
"type": "null"
}
],
"default": null
},
"tail_seconds": {
"default": 4,
"title": "Tail Seconds",
"type": "number"
},
"sample_rate": {
"default": 48000,
"title": "Sample Rate",
"type": "integer"
},
"channels": {
"default": 2,
"title": "Channels",
"type": "integer"
},
"signal_expectation": {
"default": "audible",
"title": "Signal Expectation",
"type": "string"
}
},
"required": [
"store_root",
"request_id",
"candidates",
"baseline",
"span_qn",
"question"
],
"title": "audition_planArguments",
"type": "object",
"additionalProperties": false
}attach_candidate_render Verify decoded audio and bind attributed render evidence to a candidate.
Domain: audition. Read only: false.
Python
pocket_music.auditions.attach_candidate_render(store_root: 'str', request_id: 'str', candidate: 'ArtifactHandle', render_plan: 'ArtifactHandle', path: 'str', expected_sha256: 'str', actual_settings: 'RenderSettings', native_report: 'RenderReport') -> 'dict'CLI
pocket attach-candidate-render --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"CandidateTime": {
"additionalProperties": false,
"properties": {
"n": {
"title": "N",
"type": "integer"
},
"d": {
"title": "D",
"type": "integer"
}
},
"required": [
"n",
"d"
],
"title": "CandidateTime",
"type": "object"
},
"RenderReport": {
"additionalProperties": false,
"properties": {
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"observed_at": {
"title": "Observed At",
"type": "string"
},
"candidate_sha256": {
"title": "Candidate Sha256",
"type": "string"
},
"export_completed": {
"title": "Export Completed",
"type": "boolean"
},
"arrangement_only": {
"title": "Arrangement Only",
"type": "boolean"
},
"no_missing_media": {
"title": "No Missing Media",
"type": "boolean"
}
},
"required": [
"actor",
"actor_kind",
"observed_at",
"candidate_sha256",
"export_completed",
"arrangement_only",
"no_missing_media"
],
"title": "RenderReport",
"type": "object"
},
"RenderSettings": {
"additionalProperties": false,
"properties": {
"sample_rate": {
"title": "Sample Rate",
"type": "integer"
},
"channels": {
"title": "Channels",
"type": "integer"
},
"start_qn": {
"$ref": "#/$defs/CandidateTime"
},
"end_qn": {
"$ref": "#/$defs/CandidateTime"
},
"tempo_bpm": {
"title": "Tempo Bpm",
"type": "number"
},
"tail_seconds": {
"title": "Tail Seconds",
"type": "number"
},
"normalization": {
"const": false,
"title": "Normalization",
"type": "boolean"
}
},
"required": [
"sample_rate",
"channels",
"start_qn",
"end_qn",
"tempo_bpm",
"tail_seconds",
"normalization"
],
"title": "RenderSettings",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"candidate": {
"$ref": "#/$defs/ArtifactHandle"
},
"render_plan": {
"$ref": "#/$defs/ArtifactHandle"
},
"path": {
"title": "Path",
"type": "string"
},
"expected_sha256": {
"title": "Expected Sha256",
"type": "string"
},
"actual_settings": {
"$ref": "#/$defs/RenderSettings"
},
"native_report": {
"$ref": "#/$defs/RenderReport"
}
},
"required": [
"store_root",
"request_id",
"candidate",
"render_plan",
"path",
"expected_sha256",
"actual_settings",
"native_report"
],
"title": "attach_candidate_renderArguments",
"type": "object",
"additionalProperties": false
}audition_feedback Record attributed, interval-scoped listening feedback separately from measurements.
Domain: audition. Read only: false.
Python
pocket_music.auditions.audition_feedback(store_root: 'str', request_id: 'str', attachment: 'ArtifactHandle', interval_frames: 'list[int]', actor: 'str', actor_kind: 'str', note: 'str', decision: 'str | None' = None) -> 'dict'CLI
pocket audition-feedback --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"attachment": {
"$ref": "#/$defs/ArtifactHandle"
},
"interval_frames": {
"items": {
"type": "integer"
},
"title": "Interval Frames",
"type": "array"
},
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"title": "Actor Kind",
"type": "string"
},
"note": {
"title": "Note",
"type": "string"
},
"decision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Decision"
}
},
"required": [
"store_root",
"request_id",
"attachment",
"interval_frames",
"actor",
"actor_kind",
"note"
],
"title": "audition_feedbackArguments",
"type": "object",
"additionalProperties": false
}audition_feedback_query Retrieve explicitly supplied feedback with exact render, interval and actor identity; no preference inference.
Domain: audition. Read only: true.
Python
pocket_music.feedback_query.audition_feedback_query(*, store_root: 'str', feedback: 'list[ArtifactHandle]', actor: 'str | None' = None, actor_kind: "Literal['human', 'agent'] | None" = None, decision: "Literal['keep', 'revise', 'reject', 'no_addition'] | None" = None, render_sha256: 'str | None' = None, interval_frames: 'list[int] | None' = None, limit: 'int' = 16, cursor: 'str | None' = None, max_bytes: 'int' = 16384) -> 'dict'CLI
pocket audition-feedback-query --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"feedback": {
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"title": "Feedback",
"type": "array"
},
"actor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Actor"
},
"actor_kind": {
"anyOf": [
{
"enum": [
"human",
"agent"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Actor Kind"
},
"decision": {
"anyOf": [
{
"enum": [
"keep",
"revise",
"reject",
"no_addition"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Decision"
},
"render_sha256": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Render Sha256"
},
"interval_frames": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Interval Frames"
},
"limit": {
"default": 16,
"title": "Limit",
"type": "integer"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cursor"
},
"max_bytes": {
"default": 16384,
"title": "Max Bytes",
"type": "integer"
}
},
"required": [
"store_root",
"feedback"
],
"title": "audition_feedback_queryArguments",
"type": "object",
"additionalProperties": false
}promote_candidate Copy an explicitly kept candidate and seal its collected dependency lineage.
Domain: candidate. Read only: false.
Python
pocket_music.auditions.promote_candidate(store_root: 'str', request_id: 'str', candidate: 'ArtifactHandle', attachment: 'ArtifactHandle', decision: 'AttributedDecision', output_dir: 'str', portability_target: 'str' = 'editable_same_environment', related_artifacts: 'list[ArtifactHandle] | None' = None) -> 'dict'CLI
pocket promote-candidate --spec <arguments.json>MCP input schema
{
"$defs": {
"ArtifactHandle": {
"additionalProperties": false,
"properties": {
"schema": {
"const": "pocket.artifact-handle/v1",
"title": "Schema",
"type": "string"
},
"artifact_uri": {
"title": "Artifact Uri",
"type": "string"
},
"sha256": {
"title": "Sha256",
"type": "string"
},
"artifact_schema": {
"title": "Artifact Schema",
"type": "string"
}
},
"required": [
"schema",
"artifact_uri",
"sha256",
"artifact_schema"
],
"title": "ArtifactHandle",
"type": "object"
},
"AttributedDecision": {
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"keep",
"revise",
"reject",
"no_addition"
],
"title": "Action",
"type": "string"
},
"actor": {
"title": "Actor",
"type": "string"
},
"actor_kind": {
"enum": [
"human",
"agent"
],
"title": "Actor Kind",
"type": "string"
},
"reason": {
"title": "Reason",
"type": "string"
},
"feedback": {
"$ref": "#/$defs/ArtifactHandle"
}
},
"required": [
"action",
"actor",
"actor_kind",
"reason"
],
"title": "AttributedDecision",
"type": "object"
}
},
"properties": {
"store_root": {
"title": "Store Root",
"type": "string"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"candidate": {
"$ref": "#/$defs/ArtifactHandle"
},
"attachment": {
"$ref": "#/$defs/ArtifactHandle"
},
"decision": {
"$ref": "#/$defs/AttributedDecision"
},
"output_dir": {
"title": "Output Dir",
"type": "string"
},
"portability_target": {
"default": "editable_same_environment",
"title": "Portability Target",
"type": "string"
},
"related_artifacts": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/ArtifactHandle"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Related Artifacts"
}
},
"required": [
"store_root",
"request_id",
"candidate",
"attachment",
"decision",
"output_dir"
],
"title": "promote_candidateArguments",
"type": "object",
"additionalProperties": false
}validate_candidate_promotion Recheck relocated v3 promotion bytes, dependencies and evidence.
Domain: candidate. Read only: true.
Python
pocket_music.auditions.validate_candidate_promotion(promotion_dir: 'str', expected_lineage_sha256: 'str') -> 'dict'CLI
pocket validate-candidate-promotion --spec <arguments.json>MCP input schema
{
"properties": {
"promotion_dir": {
"title": "Promotion Dir",
"type": "string"
},
"expected_lineage_sha256": {
"title": "Expected Lineage Sha256",
"type": "string"
}
},
"required": [
"promotion_dir",
"expected_lineage_sha256"
],
"title": "validate_candidate_promotionArguments",
"type": "object",
"additionalProperties": false
}Other MCP registrations#
Tool-family names (such as peek and thread) and compatibility aliases route to the providers above; they are not separate operations. Their exact input schemas are in the complete MCP download.
acquire_source, analyze_region, arrangement_position, attach_completed_render, baste, baste_build_device, build_embedding_index, capabilities_list, create_record_bag, create_trial, discover_sources, execute_spotify_playlist, export_set_map, find_clips, identify_audio, import_spotify_items, inspect_set, inspect_source_formats, model_preflight, peek, pipette, pipette_validate, plan_acquisition, plan_set_routes, plan_spotify_playlist, prepare_native_trial, prepare_session, query_feedback, query_record_bag, query_set_region, rank_embedding_query, record_feedback, record_plan_feedback, replan_set, revise_record_bag, session_options, session_snapshot, source_position, stitch, stitch_attach_render, stitch_feedback, stitch_feedback_list, stitch_prepare_native, stitch_validate_native, thread, thread_arrangement_position, thread_export, thread_find_clips, thread_region, thread_source_position, update_session, validate_native_trial, verify_spotify_playlist_ui, weave, weave_feedback, weave_replan, whisker, whisker_prepare, whisker_snapshot, whisker_update