@rho-workspace/rho 0.5.4 → 0.5.6

package/protocol/operations/extension.describe.json

@@ -0,0 +1,195 @@
+{
+  "method": "extension.describe",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 1024
+      },
+      "pluginId": {
+        "type": "string",
+        "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+      }
+    },
+    "required": [
+      "projectId",
+      "pluginId"
+    ],
+    "additionalProperties": false
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "id": {
+        "type": "string",
+        "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+      },
+      "name": {
+        "type": "string"
+      },
+      "version": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      },
+      "description": {
+        "type": "string"
+      },
+      "digest": {
+        "type": "string",
+        "pattern": "^[a-f0-9]{64}$"
+      },
+      "source": {
+        "type": "string"
+      },
+      "sourceCommit": {
+        "type": "string"
+      },
+      "enabled": {
+        "type": "boolean"
+      },
+      "installedAt": {
+        "type": "string"
+      },
+      "manifest": {
+        "type": "object",
+        "properties": {
+          "apiVersion": {
+            "const": 1
+          },
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+          },
+          "title": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "host": {
+            "type": "string"
+          },
+          "operations": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "description": {
+                  "type": "string"
+                },
+                "effect": {
+                  "enum": [
+                    "read",
+                    "native"
+                  ]
+                },
+                "methods": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "inputSchema": {
+                  "type": "object",
+                  "additionalProperties": true
+                }
+              },
+              "required": [
+                "id",
+                "title",
+                "description",
+                "effect",
+                "methods",
+                "inputSchema"
+              ],
+              "additionalProperties": true
+            }
+          },
+          "skills": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "file": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id",
+                "title",
+                "file"
+              ],
+              "additionalProperties": true
+            }
+          },
+          "views": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "file": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id",
+                "title",
+                "file"
+              ],
+              "additionalProperties": true
+            }
+          }
+        },
+        "required": [
+          "apiVersion",
+          "id",
+          "title",
+          "description",
+          "operations",
+          "skills",
+          "views"
+        ],
+        "additionalProperties": true
+      }
+    },
+    "required": [
+      "id",
+      "name",
+      "version",
+      "title",
+      "description",
+      "digest",
+      "source",
+      "enabled",
+      "installedAt",
+      "manifest"
+    ],
+    "additionalProperties": false
+  },
+  "description": "Read an installed third-party package manifest, operation input schemas, required Rho methods, Skills and views. Read its Skill with extension.content before use. Disabled packages cannot run."
+}

package/protocol/operations/extension.install.json

@@ -0,0 +1,198 @@
+{
+  "method": "extension.install",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "source": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 1024
+      },
+      "replace": {
+        "type": "string",
+        "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+      },
+      "expectedDigest": {
+        "type": "string",
+        "pattern": "^[a-f0-9]{64}$"
+      }
+    },
+    "required": [
+      "source"
+    ],
+    "additionalProperties": false
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "id": {
+        "type": "string",
+        "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+      },
+      "name": {
+        "type": "string"
+      },
+      "version": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      },
+      "description": {
+        "type": "string"
+      },
+      "digest": {
+        "type": "string",
+        "pattern": "^[a-f0-9]{64}$"
+      },
+      "source": {
+        "type": "string"
+      },
+      "sourceCommit": {
+        "type": "string"
+      },
+      "enabled": {
+        "type": "boolean"
+      },
+      "installedAt": {
+        "type": "string"
+      },
+      "manifest": {
+        "type": "object",
+        "properties": {
+          "apiVersion": {
+            "const": 1
+          },
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+          },
+          "title": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "host": {
+            "type": "string"
+          },
+          "operations": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "description": {
+                  "type": "string"
+                },
+                "effect": {
+                  "enum": [
+                    "read",
+                    "native"
+                  ]
+                },
+                "methods": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "inputSchema": {
+                  "type": "object",
+                  "additionalProperties": true
+                }
+              },
+              "required": [
+                "id",
+                "title",
+                "description",
+                "effect",
+                "methods",
+                "inputSchema"
+              ],
+              "additionalProperties": true
+            }
+          },
+          "skills": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "file": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id",
+                "title",
+                "file"
+              ],
+              "additionalProperties": true
+            }
+          },
+          "views": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "file": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id",
+                "title",
+                "file"
+              ],
+              "additionalProperties": true
+            }
+          }
+        },
+        "required": [
+          "apiVersion",
+          "id",
+          "title",
+          "description",
+          "operations",
+          "skills",
+          "views"
+        ],
+        "additionalProperties": true
+      }
+    },
+    "required": [
+      "id",
+      "name",
+      "version",
+      "title",
+      "description",
+      "digest",
+      "source",
+      "enabled",
+      "installedAt",
+      "manifest"
+    ],
+    "additionalProperties": false
+  },
+  "description": "Local person/operator: install a trusted prebuilt npm package, local folder, tarball, or Git source. Lifecycle scripts are disabled. Replacement stages and checks the new package before switching; use replace and expectedDigest for updates."
+}

package/protocol/operations/extension.list.json

@@ -0,0 +1,123 @@
+{
+  "method": "extension.list",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 1024
+      }
+    },
+    "required": [],
+    "additionalProperties": false
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "plugins": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+            },
+            "name": {
+              "type": "string"
+            },
+            "version": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            },
+            "digest": {
+              "type": "string",
+              "pattern": "^[a-f0-9]{64}$"
+            },
+            "source": {
+              "type": "string"
+            },
+            "sourceCommit": {
+              "type": "string"
+            },
+            "enabled": {
+              "type": "boolean"
+            },
+            "installedAt": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "name",
+            "version",
+            "title",
+            "description",
+            "digest",
+            "source",
+            "enabled",
+            "installedAt"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "directory": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+            },
+            "title": {
+              "type": "string"
+            },
+            "version": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            },
+            "source": {
+              "type": "string"
+            },
+            "repository": {
+              "type": "string"
+            },
+            "needs": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "title",
+            "version",
+            "description",
+            "source",
+            "repository",
+            "needs"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "limits": {
+        "type": "object",
+        "additionalProperties": true
+      }
+    },
+    "required": [
+      "plugins",
+      "directory",
+      "limits"
+    ],
+    "additionalProperties": false
+  },
+  "description": "List independently installed third-party packages and their enabled state, source and immutable digest. Reads start no plugin or runtime. Use extension.describe to discover operation schemas and Skills."
+}

package/protocol/operations/extension.manage.json

@@ -0,0 +1,55 @@
+{
+  "method": "extension.manage",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "pluginId": {
+        "type": "string",
+        "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+      },
+      "expectedDigest": {
+        "type": "string",
+        "pattern": "^[a-f0-9]{64}$"
+      },
+      "action": {
+        "enum": [
+          "enable",
+          "disable",
+          "remove"
+        ]
+      }
+    },
+    "required": [
+      "pluginId",
+      "expectedDigest",
+      "action"
+    ],
+    "additionalProperties": false
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "pluginId": {
+        "type": "string",
+        "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+      },
+      "action": {
+        "enum": [
+          "enable",
+          "disable",
+          "remove"
+        ]
+      },
+      "retained": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "pluginId",
+      "action",
+      "retained"
+    ],
+    "additionalProperties": false
+  },
+  "description": "Local person/operator: enable, disable or remove an installed third-party package at the expected digest. Existing native tasks, R sessions, project files and retained receipts are preserved."
+}

package/protocol/operations/extension.read.json

@@ -0,0 +1,112 @@
+{
+  "method": "extension.read",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 1024
+      },
+      "invocationId": {
+        "type": "string",
+        "pattern": "^[a-f0-9]{64}$"
+      }
+    },
+    "required": [
+      "projectId",
+      "invocationId"
+    ],
+    "additionalProperties": false
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "invocationId": {
+        "type": "string",
+        "pattern": "^[a-f0-9]{64}$"
+      },
+      "caller": {
+        "type": "string"
+      },
+      "projectId": {
+        "type": "string"
+      },
+      "pluginId": {
+        "type": "string",
+        "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+      },
+      "packageDigest": {
+        "type": "string",
+        "pattern": "^[a-f0-9]{64}$"
+      },
+      "operation": {
+        "type": "string",
+        "pattern": "^[a-z0-9][a-z0-9._-]{0,95}$"
+      },
+      "requestDigest": {
+        "type": "string",
+        "pattern": "^[a-f0-9]{64}$"
+      },
+      "state": {
+        "enum": [
+          "pending",
+          "completed",
+          "unknown"
+        ]
+      },
+      "startedAt": {
+        "type": "string"
+      },
+      "endedAt": {
+        "type": "string"
+      },
+      "value": {},
+      "error": {
+        "type": "string"
+      },
+      "delegations": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "method": {
+              "type": "string"
+            },
+            "request": {},
+            "state": {
+              "enum": [
+                "pending",
+                "completed",
+                "unknown"
+              ]
+            },
+            "value": {},
+            "error": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "method",
+            "request",
+            "state"
+          ],
+          "additionalProperties": false
+        }
+      }
+    },
+    "required": [
+      "invocationId",
+      "caller",
+      "projectId",
+      "pluginId",
+      "packageDigest",
+      "operation",
+      "requestDigest",
+      "state",
+      "startedAt"
+    ],
+    "additionalProperties": false
+  },
+  "description": "Observe an original plugin invocation, including pending or unknown outcomes. Never reruns code. Only its original caller can read it."
+}