@mininglamp-oss/octo-runtime 1.0.1 → 1.1.1

package/packages/octo-runtime-extra-webui/config-schema.json

@@ -6,12 +6,12 @@
   "$comment": "声明文件最多 1 MiB，POSIX 权限须为 0600。端口占用、路径可访问性、会话文件内容及文件权限仍需运行时检查。加载生命周期 loaded 不等于监听成功，宿主须检查插件状态中的 listening 与 errors。",
   "type": "object",
   "additionalProperties": false,
-  "required": ["module", "config"],
+  "required": ["config"],
   "properties": {
     "module": {
       "type": "string",
       "const": "@mininglamp-oss/octo-runtime-extra-webui",
-      "description": "必填。本地 WebUI Extra 的固定包入口；宿主须预先安装并确保模块可解析。此 schema 约束包名声明，宿主通过绝对路径加载同一模块时可自行调整该约束。插件实例名及 CLI 配置目录名为 webui。"
+      "description": "可选旧声明。CLI 从 manifest.json 选择模块；省略时使用有效清单，保留时须与清单文字一致。SDK 原生 import 不需要此字段。此 schema 约束固定包名，宿主使用其他公开路径时可自行调整。"
     },
     "enabled": {
       "type": "boolean",

package/packages/octo-runtime-protocol/schema/kernel-ipc-fixtures.json

@@ -0,0 +1,53 @@
+{
+  "ipc_version": 1,
+  "cases": [
+    {
+      "name": "status",
+      "request": { "jsonrpc": "2.0", "id": "status-1", "method": "status", "params": {} },
+      "valid": true,
+      "result_definition": "KernelStatus"
+    },
+    {
+      "name": "list",
+      "request": { "jsonrpc": "2.0", "id": "list-1", "method": "adapter.list", "params": {} },
+      "valid": true
+    },
+    {
+      "name": "missing-run",
+      "request": {
+        "jsonrpc": "2.0",
+        "id": "get-1",
+        "method": "agent_run.get",
+        "params": {
+          "key": {
+            "run_id": "r1",
+            "invocation_id": "i1",
+            "agent_session_id": "s1",
+            "session_generation": 0,
+            "protocol_mode": "native"
+          }
+        }
+      },
+      "valid": true,
+      "error_code": "RUN_NOT_AVAILABLE"
+    },
+    {
+      "name": "numeric-id",
+      "request": { "jsonrpc": "2.0", "id": 1, "method": "status", "params": {} },
+      "valid": false,
+      "error_code": "INVALID_REQUEST"
+    },
+    {
+      "name": "unknown-params",
+      "request": {
+        "jsonrpc": "2.0",
+        "id": "bad-1",
+        "method": "status",
+        "params": { "extra": true }
+      },
+      "valid": false,
+      "error_code": "INVALID_PARAMS"
+    },
+    { "name": "batch", "request": [], "valid": false, "error_code": "INVALID_REQUEST" }
+  ]
+}

package/packages/octo-runtime-protocol/schema/kernel-ipc.schema.json

@@ -0,0 +1,151 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "urn:mininglamp-oss:octo-runtime:kernel-ipc:v1",
+  "title": "Kernel IPC v1",
+  "description": "One UTF-8 LF-terminated JSON-RPC request per local connection. No batches. Closing a connection never cancels execution. Source sequence numbers belong to the Kernel instance. Receipts and events retain the original Run protocol identities.",
+  "definitions": {
+    "Request": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["jsonrpc", "id", "method", "params"],
+      "properties": {
+        "jsonrpc": { "const": "2.0" },
+        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "method": {
+          "enum": [
+            "status",
+            "adapter.list",
+            "agent_run.invoke",
+            "agent_run.get",
+            "agent_run.subscribe",
+            "agent_run.cancel",
+            "agent_run.respond",
+            "agent_run.native.respond"
+          ]
+        },
+        "params": { "type": "object" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "method": { "enum": ["status", "adapter.list"] } } },
+          "then": { "properties": { "params": { "maxProperties": 0 } } }
+        },
+        {
+          "if": { "properties": { "method": { "const": "agent_run.invoke" } } },
+          "then": {
+            "properties": {
+              "params": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["input"],
+                "properties": {
+                  "input": { "type": "object" },
+                  "executionEnvOverrides": { "type": "object" },
+                  "kernel_instance_id": { "type": "string", "minLength": 1 }
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "method": { "const": "agent_run.get" } } },
+          "then": {
+            "properties": {
+              "params": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["key"],
+                "properties": {
+                  "key": {
+                    "$ref": "urn:mininglamp-oss:octo-runtime:protocol-schema#/definitions/KernelLookupKey"
+                  },
+                  "kernel_instance_id": { "type": "string", "minLength": 1 }
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "method": { "const": "agent_run.subscribe" } } },
+          "then": {
+            "properties": {
+              "params": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["ref", "after_seq"],
+                "properties": {
+                  "ref": {
+                    "$ref": "urn:mininglamp-oss:octo-runtime:protocol-schema#/definitions/KernelRunRef"
+                  },
+                  "after_seq": { "type": "integer", "minimum": 0 }
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "method": { "const": "agent_run.cancel" } } },
+          "then": {
+            "properties": {
+              "params": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["ref"],
+                "properties": {
+                  "ref": {
+                    "$ref": "urn:mininglamp-oss:octo-runtime:protocol-schema#/definitions/KernelRunRef"
+                  },
+                  "reason": { "type": "string" }
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "method": { "enum": ["agent_run.respond", "agent_run.native.respond"] }
+            }
+          },
+          "then": {
+            "properties": {
+              "params": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["ref", "response"],
+                "properties": {
+                  "ref": {
+                    "$ref": "urn:mininglamp-oss:octo-runtime:protocol-schema#/definitions/KernelRunRef"
+                  },
+                  "response": { "type": "object" }
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "BusinessErrorCode": {
+      "enum": [
+        "KERNEL_UNAVAILABLE",
+        "KERNEL_INSTANCE_CHANGED",
+        "RUN_IDENTITY_MISMATCH",
+        "RUN_NOT_AVAILABLE",
+        "RUN_ALREADY_ACCEPTED",
+        "RUN_CAPACITY_EXHAUSTED",
+        "STREAM_GAP",
+        "STREAM_EXPIRED",
+        "STREAM_CURSOR_INVALID",
+        "STREAM_SUBSCRIBER_LIMIT",
+        "ACCEPTANCE_UNKNOWN",
+        "OPERATION_OUTCOME_UNKNOWN",
+        "CLIENT_CLOSED",
+        "WORKER_LOST",
+        "WORKER_RESTART_EXHAUSTED",
+        "INVOKE_REQUEST_TOO_LARGE",
+        "HOST_FRAME_TOO_LARGE"
+      ]
+    }
+  },
+  "$ref": "#/definitions/Request"
+}