{
  "interface": "Jellybox WebMCP Framework Interface",
  "interfaceEdition": "1.0",
  "interfaceProfile": "standalone-core",
  "protocolVersion": "1.0",
  "tools": [
    {
      "name": "readme",
      "description": "Start here. Introduce this website’s Jellybox Virtual Web Space, explain its contexts and actions, and start or resume an interaction without changing the human view.",
      "inputSchema": {
        "$defs": {
          "Target": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "instanceId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "kind": {
                "enum": [
                  "jellybox",
                  "jellyhub"
                ]
              }
            },
            "required": [
              "kind",
              "id",
              "instanceId"
            ],
            "type": "object"
          }
        },
        "$id": "urn:jellybox:protocol:1.0:readme",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "interactionId": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          },
          "target": {
            "anyOf": [
              {
                "enum": [
                  "jellyhub",
                  "active_jellybox"
                ]
              },
              {
                "$ref": "#/$defs/Target"
              }
            ],
            "description": "Omit to describe this application: its Jellyhub, or its standalone Jellybox. Use jellyhub, active_jellybox, or an exact returned Target reference. Reading another introduction preserves an existing interaction context."
          },
          "topics": {
            "items": {
              "type": "string"
            },
            "maxItems": 20,
            "type": "array"
          }
        },
        "required": [],
        "type": "object"
      },
      "annotations": {
        "readOnlyHint": false,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    },
    {
      "name": "current_context",
      "description": "Read this interaction’s selected context and the person’s current view as separate state, without performing an action or navigating.",
      "inputSchema": {
        "$id": "urn:jellybox:protocol:1.0:current_context",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "interactionId": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "interactionId"
        ],
        "type": "object"
      },
      "annotations": {
        "readOnlyHint": true,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    },
    {
      "name": "list_contexts",
      "description": "Discover the contexts available in this Jellybox Virtual Web Space without selecting one or moving the person’s page.",
      "inputSchema": {
        "$defs": {
          "Target": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "instanceId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "kind": {
                "enum": [
                  "jellybox",
                  "jellyhub"
                ]
              }
            },
            "required": [
              "kind",
              "id",
              "instanceId"
            ],
            "type": "object"
          }
        },
        "$id": "urn:jellybox:protocol:1.0:list_contexts",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "cursor": {
            "anyOf": [
              {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "interactionId": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          },
          "limit": {
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "mode": {
            "enum": [
              "available",
              "discoverable"
            ]
          },
          "target": {
            "$ref": "#/$defs/Target"
          }
        },
        "required": [
          "interactionId"
        ],
        "type": "object"
      },
      "annotations": {
        "readOnlyHint": true,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    },
    {
      "name": "enter_context",
      "description": "Select a context as this interaction’s place of work using its exact reference and current selection revision. The human view stays in place.",
      "inputSchema": {
        "$defs": {
          "EntityRef": {
            "additionalProperties": false,
            "properties": {
              "entityId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "target": {
                "$ref": "#/$defs/Target"
              }
            },
            "required": [
              "target",
              "entityId"
            ],
            "type": "object"
          },
          "Target": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "instanceId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "kind": {
                "enum": [
                  "jellybox",
                  "jellyhub"
                ]
              }
            },
            "required": [
              "kind",
              "id",
              "instanceId"
            ],
            "type": "object"
          }
        },
        "$id": "urn:jellybox:protocol:1.0:enter_context",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "contextRef": {
            "$ref": "#/$defs/EntityRef"
          },
          "expectedSelectionRevision": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          },
          "interactionId": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "interactionId",
          "contextRef",
          "expectedSelectionRevision"
        ],
        "type": "object"
      },
      "annotations": {
        "readOnlyHint": false,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    },
    {
      "name": "list_actions",
      "description": "Discover current action summaries in the selected context or inspect another context without selecting it. Availability can change as work progresses.",
      "inputSchema": {
        "$defs": {
          "EntityRef": {
            "additionalProperties": false,
            "properties": {
              "entityId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "target": {
                "$ref": "#/$defs/Target"
              }
            },
            "required": [
              "target",
              "entityId"
            ],
            "type": "object"
          },
          "Target": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "instanceId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "kind": {
                "enum": [
                  "jellybox",
                  "jellyhub"
                ]
              }
            },
            "required": [
              "kind",
              "id",
              "instanceId"
            ],
            "type": "object"
          }
        },
        "$id": "urn:jellybox:protocol:1.0:list_actions",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "contextRef": {
            "$ref": "#/$defs/EntityRef"
          },
          "cursor": {
            "anyOf": [
              {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "interactionId": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          },
          "limit": {
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "mode": {
            "enum": [
              "available",
              "discoverable"
            ]
          },
          "target": {
            "$ref": "#/$defs/Target"
          }
        },
        "required": [
          "interactionId"
        ],
        "type": "object"
      },
      "annotations": {
        "readOnlyHint": true,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    },
    {
      "name": "describe_actions",
      "description": "Read complete action descriptions, parameter and result schemas, effects, preconditions and execution bindings in the selected context.",
      "inputSchema": {
        "$defs": {
          "EntityRef": {
            "additionalProperties": false,
            "properties": {
              "entityId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "target": {
                "$ref": "#/$defs/Target"
              }
            },
            "required": [
              "target",
              "entityId"
            ],
            "type": "object"
          },
          "Target": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "instanceId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "kind": {
                "enum": [
                  "jellybox",
                  "jellyhub"
                ]
              }
            },
            "required": [
              "kind",
              "id",
              "instanceId"
            ],
            "type": "object"
          }
        },
        "$id": "urn:jellybox:protocol:1.0:describe_actions",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "actionRefs": {
            "items": {
              "$ref": "#/$defs/EntityRef"
            },
            "maxItems": 20,
            "minItems": 1,
            "type": "array"
          },
          "interactionId": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "interactionId",
          "actionRefs"
        ],
        "type": "object"
      },
      "annotations": {
        "readOnlyHint": true,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    },
    {
      "name": "perform_action",
      "description": "Perform a described action using its exact binding, validated parameters and required checks. The website enforces authority, effects and request identity.",
      "inputSchema": {
        "$defs": {
          "AspectRef": {
            "additionalProperties": false,
            "properties": {
              "aspectId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "entityId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "target": {
                "$ref": "#/$defs/Target"
              }
            },
            "required": [
              "target",
              "entityId",
              "aspectId"
            ],
            "type": "object"
          },
          "Binding": {
            "additionalProperties": false,
            "properties": {
              "capabilityUse": {
                "$ref": "#/$defs/EntityRef"
              },
              "capabilityUseRevision": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "contextRef": {
                "$ref": "#/$defs/EntityRef"
              },
              "descriptorRevision": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "selectionRevision": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "target": {
                "$ref": "#/$defs/Target"
              }
            },
            "required": [
              "target",
              "descriptorRevision"
            ],
            "type": "object"
          },
          "EntityRef": {
            "additionalProperties": false,
            "properties": {
              "entityId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "target": {
                "$ref": "#/$defs/Target"
              }
            },
            "required": [
              "target",
              "entityId"
            ],
            "type": "object"
          },
          "RevisionCheck": {
            "additionalProperties": false,
            "properties": {
              "ref": {
                "$ref": "#/$defs/SubjectRef"
              },
              "revision": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "ref",
              "revision"
            ],
            "type": "object"
          },
          "SubjectRef": {
            "oneOf": [
              {
                "$ref": "#/$defs/EntityRef"
              },
              {
                "$ref": "#/$defs/AspectRef"
              }
            ]
          },
          "Target": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "instanceId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "kind": {
                "enum": [
                  "jellybox",
                  "jellyhub"
                ]
              }
            },
            "required": [
              "kind",
              "id",
              "instanceId"
            ],
            "type": "object"
          }
        },
        "$id": "urn:jellybox:protocol:1.0:perform_action",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "actionRef": {
            "$ref": "#/$defs/EntityRef"
          },
          "binding": {
            "$ref": "#/$defs/Binding"
          },
          "interactionId": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          },
          "parameters": {
            "type": "object"
          },
          "preconditions": {
            "items": {
              "$ref": "#/$defs/RevisionCheck"
            },
            "maxItems": 100,
            "type": "array"
          },
          "requestId": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "interactionId",
          "actionRef",
          "binding",
          "parameters"
        ],
        "type": "object"
      },
      "annotations": {
        "readOnlyHint": false,
        "untrustedContentHint": true,
        "consequentialHint": true
      }
    },
    {
      "name": "navigate_to_view",
      "description": "Deliberately show a discovered human-facing view. Preserve this interaction’s context by default; adoption of the view’s context is explicit and revision-checked.",
      "inputSchema": {
        "$defs": {
          "EntityRef": {
            "additionalProperties": false,
            "properties": {
              "entityId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "target": {
                "$ref": "#/$defs/Target"
              }
            },
            "required": [
              "target",
              "entityId"
            ],
            "type": "object"
          },
          "Target": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "instanceId": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              },
              "kind": {
                "enum": [
                  "jellybox",
                  "jellyhub"
                ]
              }
            },
            "required": [
              "kind",
              "id",
              "instanceId"
            ],
            "type": "object"
          }
        },
        "$id": "urn:jellybox:protocol:1.0:navigate_to_view",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "contextBehavior": {
            "enum": [
              "preserve",
              "use_view_default"
            ]
          },
          "expectedSelectionRevision": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          },
          "interactionId": {
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          },
          "viewRef": {
            "$ref": "#/$defs/EntityRef"
          }
        },
        "required": [
          "interactionId",
          "viewRef"
        ],
        "type": "object"
      },
      "annotations": {
        "readOnlyHint": false,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    }
  ]
}
