arcane-os 0.1.0-dev.5

package/schemas/arcane-package.schema.json

@@ -0,0 +1,224 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/TheWizardNexus/arcane-os-sdk/schemas/arcane-package.schema.json",
+  "title": "Arcane application package",
+  "description": "Authored application input accepted by the Arcane application packager.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "id",
+    "displayName",
+    "version",
+    "entry",
+    "strategy",
+    "security",
+    "include",
+    "shared"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "id": {
+      "$ref": "#/$defs/appId"
+    },
+    "displayName": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 160,
+      "pattern": "^(?=.*\\S)[^<>\\u0000-\\u001f\\u007f]+$"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-(?:0|[1-9][0-9]*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9][0-9]*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$"
+    },
+    "entry": {
+      "$ref": "#/$defs/relativePath"
+    },
+    "strategy": {
+      "enum": [
+        "static",
+        "adapter"
+      ]
+    },
+    "localAIModelPolicy": {
+      "$ref": "#/$defs/localAIModelPolicy"
+    },
+    "security": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "connectOrigins",
+        "frameOrigins",
+        "mediaOrigins"
+      ],
+      "properties": {
+        "connectOrigins": {
+          "$ref": "#/$defs/connectOriginList"
+        },
+        "frameOrigins": {
+          "$ref": "#/$defs/frameOriginList"
+        },
+        "mediaOrigins": {
+          "$ref": "#/$defs/httpsOriginList"
+        }
+      }
+    },
+    "include": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/pathList"
+        },
+        {
+          "minItems": 1
+        }
+      ]
+    },
+    "exclude": {
+      "$ref": "#/$defs/pathList"
+    },
+    "shared": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+      }
+    },
+    "adapter": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/relativePath"
+        },
+        {
+          "pattern": "^scripts/[A-Za-z0-9._/-]+\\.mjs$"
+        }
+      ]
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "strategy": {
+            "const": "adapter"
+          }
+        },
+        "required": [
+          "strategy"
+        ]
+      },
+      "then": {
+        "required": [
+          "adapter"
+        ]
+      },
+      "else": {
+        "not": {
+          "required": [
+            "adapter"
+          ]
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "appId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+    },
+    "relativePath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!.*\\\\)(?!.*:)(?!.*[<>\"|?*])(?!.*(?:^|/)(?:\\.{1,2}|(?:[Cc][Oo][Nn]|[Pp][Rr][Nn]|[Aa][Uu][Xx]|[Nn][Uu][Ll]|[Cc][Ll][Oo][Cc][Kk]\\$|[Cc][Oo][Nn][Ii][Nn]\\$|[Cc][Oo][Nn][Oo][Uu][Tt]\\$|[Cc][Oo][Mm][1-9¹²³]|[Ll][Pp][Tt][1-9¹²³])(?:\\.[^/]*)?)(?:/|$))(?!.*[. ](?:/|$))[^/\\u0000-\\u001f\\u007f]+(?:/[^/\\u0000-\\u001f\\u007f]+)*$"
+    },
+    "literalRelativePath": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/relativePath"
+        },
+        {
+          "pattern": "^[^*?\\[\\]{}]+$"
+        }
+      ]
+    },
+    "pathList": {
+      "type": "array",
+      "maxItems": 512,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/$defs/literalRelativePath"
+      }
+    },
+    "connectOriginList": {
+      "type": "array",
+      "maxItems": 16,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^(?:https://[^/?#]+|http://(?:127\\.0\\.0\\.1|\\[::1\\])(?::[0-9]{1,5})?)$"
+      }
+    },
+    "httpsOriginList": {
+      "type": "array",
+      "maxItems": 16,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^https://[^/?#]+$"
+      }
+    },
+    "frameOriginList": {
+      "type": "array",
+      "maxItems": 16,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^(?:https:|https://[^/?#]+)$"
+      }
+    },
+    "localAIModelPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "verified_only",
+        "models"
+      ],
+      "properties": {
+        "verified_only": {
+          "type": "boolean"
+        },
+        "models": {
+          "type": "array",
+          "maxItems": 64,
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "name",
+              "definition"
+            ],
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._/-]{0,191}(?::[A-Za-z0-9][A-Za-z0-9._-]{0,63})?$",
+                "not": {
+                  "pattern": "^[Oo][Pp][Ee][Nn][Aa][Ii]$"
+                }
+              },
+              "definition": {
+                "type": "string",
+                "maxLength": 128,
+                "pattern": "^(?:Modelfile|[A-Za-z0-9][A-Za-z0-9._-]{0,118}\\.Modelfile)$"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/cli-event.schema.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/TheWizardNexus/arcane-os-sdk/schemas/cli-event.schema.json",
+  "title": "Arcane CLI event",
+  "description": "One ordered NDJSON event emitted by an Arcane CLI operation.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "operationId",
+    "sequence",
+    "timestamp",
+    "command",
+    "type",
+    "status"
+  ],
+  "properties": {
+    "protocol": {
+      "const": "arcane-cli-events/1"
+    },
+    "operationId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "sequence": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "type": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9]*)+$"
+    },
+    "command": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "enum": [
+        "accepted",
+        "running",
+        "completed",
+        "failed",
+        "cancelled"
+      ]
+    },
+    "message": {
+      "type": "string"
+    },
+    "data": {}
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "operation.accepted"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "status": {
+            "const": "accepted"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "operation.completed"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "status": {
+            "const": "completed"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "operation.failed"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "status": {
+            "const": "failed"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "operation.cancelled"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "status": {
+            "const": "cancelled"
+          }
+        }
+      }
+    }
+  ]
+}

package/schemas/event-stack.schema.json

@@ -0,0 +1,152 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://thewizardnexus.github.io/arcane-os-sdk/schemas/event-stack.schema.json",
+  "title": "Arcane Event Stack",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "sessionId",
+    "createdAt",
+    "events"
+  ],
+  "properties": {
+    "protocol": {
+      "const": "arcane-event-stack/1"
+    },
+    "sessionId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/event"
+      }
+    }
+  },
+  "$defs": {
+    "nullableString": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "event": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "protocol",
+        "sessionId",
+        "id",
+        "sequence",
+        "timestamp",
+        "monotonicMs",
+        "type",
+        "source",
+        "category",
+        "correlationId",
+        "causationId",
+        "parentSequence",
+        "depth",
+        "stack",
+        "payload",
+        "metadata",
+        "status",
+        "completedAt",
+        "durationMs",
+        "error"
+      ],
+      "properties": {
+        "protocol": {
+          "const": "arcane-event-stack/1"
+        },
+        "sessionId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "monotonicMs": {
+          "type": "number"
+        },
+        "type": {
+          "type": "string"
+        },
+        "source": {
+          "type": "string",
+          "minLength": 1
+        },
+        "category": {
+          "$ref": "#/$defs/nullableString"
+        },
+        "correlationId": {
+          "$ref": "#/$defs/nullableString"
+        },
+        "causationId": {
+          "$ref": "#/$defs/nullableString"
+        },
+        "parentSequence": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1
+        },
+        "depth": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "stack": {
+          "$ref": "#/$defs/nullableString"
+        },
+        "payload": {
+          "type": "array"
+        },
+        "metadata": {
+          "type": "object"
+        },
+        "status": {
+          "enum": [
+            "dispatching",
+            "completed",
+            "failed"
+          ]
+        },
+        "completedAt": {
+          "anyOf": [
+            {
+              "type": "string",
+              "format": "date-time"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "durationMs": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "error": {}
+      }
+    }
+  }
+}

package/schemas/native-build-plan.schema.json

@@ -0,0 +1,176 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/TheWizardNexus/arcane-os-sdk/schemas/native-build-plan.schema.json",
+  "title": "Arcane native build plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["protocol", "generation", "toolchain", "minimumCoreVersion", "app", "dependencies", "targetRequest", "outputRoot", "operations"],
+  "properties": {
+    "protocol": { "const": "arcane-native-build-plan/1" },
+    "generation": { "type": "string", "pattern": "^[a-f0-9]{32}$" },
+    "providerGeneration": { "$ref": "#/$defs/providerGeneration" },
+    "toolchain": { "$ref": "#/$defs/toolchain" },
+    "minimumCoreVersion": { "$ref": "#/$defs/semver" },
+    "app": { "$ref": "#/$defs/app" },
+    "dependencies": {
+      "type": "array",
+      "maxItems": 64,
+      "items": { "$ref": "#/$defs/app" }
+    },
+    "targetRequest": { "$ref": "#/$defs/targetRequest" },
+    "outputRoot": { "type": "string", "minLength": 1 },
+    "operations": {
+      "const": [
+        "authenticate-toolchain",
+        "authenticate-app-release",
+        "authenticate-dependency-releases",
+        "build-selected-target",
+        "verify-native-artifact"
+      ]
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "semver": {
+      "type": "string",
+      "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-(?:0|[1-9][0-9]*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9][0-9]*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$"
+    },
+    "providerGeneration": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "generationSha256", "contentSha256", "moduleCount"],
+      "properties": {
+        "kind": { "const": "arcane-native-provider-generation" },
+        "generationSha256": { "$ref": "#/$defs/sha256" },
+        "contentSha256": { "$ref": "#/$defs/sha256" },
+        "moduleCount": { "type": "integer", "minimum": 1, "maximum": 128 }
+      }
+    },
+    "toolchain": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "version", "protocolVersion", "features", "supportedCapabilities", "supportedMethods", "canonicalLocation", "contentSha256"],
+      "properties": {
+        "kind": { "type": "string", "minLength": 1 },
+        "version": { "$ref": "#/$defs/semver" },
+        "protocolVersion": { "type": "string", "pattern": "^arcane/[1-9][0-9]*$" },
+        "features": { "$ref": "#/$defs/contractList" },
+        "supportedCapabilities": { "$ref": "#/$defs/contractList" },
+        "supportedMethods": { "$ref": "#/$defs/contractList" },
+        "canonicalLocation": { "type": "string", "minLength": 1 },
+        "contentSha256": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "contractList": {
+      "type": "array",
+      "maxItems": 4096,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "release": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["canonicalLocation", "policySha256", "contentSha256", "fileCount", "totalBytes"],
+      "properties": {
+        "canonicalLocation": { "type": "string", "minLength": 1 },
+        "policySha256": { "$ref": "#/$defs/sha256" },
+        "contentSha256": { "$ref": "#/$defs/sha256" },
+        "fileCount": { "type": "integer", "minimum": 1 },
+        "totalBytes": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "app": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version", "descriptorSha256", "release"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+        "version": { "type": "string", "minLength": 1 },
+        "descriptorSha256": { "$ref": "#/$defs/sha256" },
+        "release": { "$ref": "#/$defs/release" }
+      }
+    },
+    "unsignedLocalSigning": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "profileId"],
+      "properties": {
+        "mode": { "const": "unsigned-local-test" },
+        "profileId": { "type": "null" }
+      }
+    },
+    "androidDevelopmentSigning": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "profileId"],
+      "properties": {
+        "mode": { "const": "development" },
+        "profileId": { "const": "arcane-android-development-v1" }
+      }
+    },
+    "targetRequest": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["target", "platform", "architecture", "format", "signing"],
+          "properties": {
+            "target": { "const": "portable" },
+            "platform": { "enum": ["windows", "linux"] },
+            "architecture": { "enum": ["x64", "arm64"] },
+            "format": { "const": "portable" },
+            "signing": { "$ref": "#/$defs/unsignedLocalSigning" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["target", "platform", "architecture", "format", "signing"],
+          "properties": {
+            "target": { "const": "windows-x64" },
+            "platform": { "const": "windows" },
+            "architecture": { "const": "x64" },
+            "format": { "const": "exe" },
+            "signing": { "$ref": "#/$defs/unsignedLocalSigning" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["target", "platform", "architecture", "format", "signing"],
+          "properties": {
+            "target": { "const": "linux-x64" },
+            "platform": { "const": "linux" },
+            "architecture": { "const": "x64" },
+            "format": { "const": "deb" },
+            "signing": { "$ref": "#/$defs/unsignedLocalSigning" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["target", "platform", "architecture", "format", "signing"],
+          "properties": {
+            "target": { "const": "linux-arm64" },
+            "platform": { "const": "linux" },
+            "architecture": { "const": "arm64" },
+            "format": { "const": "deb" },
+            "signing": { "$ref": "#/$defs/unsignedLocalSigning" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["target", "platform", "architecture", "format", "signing"],
+          "properties": {
+            "target": { "const": "android-arm64" },
+            "platform": { "const": "android" },
+            "architecture": { "const": "arm64" },
+            "format": { "const": "apk" },
+            "signing": { "$ref": "#/$defs/androidDevelopmentSigning" }
+          }
+        }
+      ]
+    }
+  }
+}