{
  "openapi": "3.0.3",
  "info": {
    "title": "Arcnin Public Information API",
    "version": "1.0.0",
    "description": "Read-only public information about Arcnin. No authentication required."
  },
  "servers": [
    {
      "url": "https://arcnin.com"
    }
  ],
  "externalDocs": {
    "description": "Arcnin API documentation",
    "url": "https://arcnin.com/docs"
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "code",
              "message"
            ]
          }
        },
        "required": [
          "error"
        ]
      }
    }
  },
  "paths": {
    "/api/v1/product": {
      "get": {
        "operationId": "getProduct",
        "summary": "Get Arcnin’s public product overview.",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "audience": {
                      "type": "string"
                    },
                    "liveGuard": {
                      "type": "string"
                    },
                    "privacy": {
                      "type": "string"
                    },
                    "pricing": {
                      "type": "string"
                    },
                    "downloads": {
                      "type": "string"
                    },
                    "documentation": {
                      "type": "string"
                    },
                    "support": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "name",
                    "description",
                    "audience",
                    "liveGuard",
                    "privacy",
                    "pricing",
                    "downloads",
                    "documentation",
                    "support"
                  ]
                },
                "example": {
                  "name": "Arcnin",
                  "description": "Arcnin is a local desktop guard for AI agents on macOS and Windows. It can block risky actions or ask you to approve them.",
                  "audience": "People who run AI agents on their own Mac or Windows PC.",
                  "liveGuard": "Claude Code. Other supported agents can be discovered locally.",
                  "privacy": "The desktop app runs locally, with no account, analytics, or telemetry in the preview.",
                  "pricing": "https://arcnin.com/pricing",
                  "downloads": "https://arcnin.com/#download",
                  "documentation": "https://arcnin.com/docs",
                  "support": "https://github.com/Arcnin/releases/issues"
                }
              }
            }
          },
          "404": {
            "description": "Unknown endpoint",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "Method not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/downloads": {
      "get": {
        "operationId": "getDownloads",
        "summary": "Get the current release and platform installers.",
        "parameters": [
          {
            "name": "platform",
            "in": "query",
            "description": "Return only this platform’s installer.",
            "schema": {
              "type": "string",
              "enum": [
                "macArm",
                "macIntel",
                "windows"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "version": {
                      "type": "string"
                    },
                    "releases": {
                      "type": "string"
                    },
                    "installers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "platform": {
                            "type": "string"
                          },
                          "requirements": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "platform",
                          "requirements",
                          "url"
                        ]
                      }
                    }
                  },
                  "required": [
                    "version",
                    "releases",
                    "installers"
                  ]
                },
                "example": {
                  "version": "0.1.0",
                  "releases": "https://github.com/Arcnin/releases",
                  "installers": [
                    {
                      "platform": "macArm",
                      "requirements": "macOS 13 or later, Apple silicon",
                      "url": "https://github.com/Arcnin/releases/releases/download/v0.1.0/Arcnin-0.1.0-arm64.dmg"
                    },
                    {
                      "platform": "macIntel",
                      "requirements": "macOS 13 or later, Intel",
                      "url": "https://github.com/Arcnin/releases/releases/download/v0.1.0/Arcnin-0.1.0.dmg"
                    },
                    {
                      "platform": "windows",
                      "requirements": "64-bit Windows 10 or 11",
                      "url": "https://github.com/Arcnin/releases/releases/download/v0.1.0/Arcnin-Setup-0.1.0.exe"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid filter value",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown endpoint",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "Method not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/pricing": {
      "get": {
        "operationId": "getPricing",
        "summary": "Get preview availability and planned prices.",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "description": "Return only plans with this availability.",
            "schema": {
              "type": "string",
              "enum": [
                "available",
                "planned"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "currency": {
                      "type": "string"
                    },
                    "plans": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "monthlyPrice": {
                            "type": "integer"
                          },
                          "description": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "name",
                          "status",
                          "monthlyPrice",
                          "description"
                        ]
                      }
                    }
                  },
                  "required": [
                    "currency",
                    "plans"
                  ]
                },
                "example": {
                  "currency": "USD",
                  "plans": [
                    {
                      "name": "Free",
                      "status": "available",
                      "monthlyPrice": 0,
                      "description": "Agent discovery, activity history, and the Demo lab."
                    },
                    {
                      "name": "Guard",
                      "status": "planned",
                      "monthlyPrice": 6,
                      "description": "Live guard, spending controls, and approvals for sensitive actions."
                    },
                    {
                      "name": "Family",
                      "status": "planned",
                      "monthlyPrice": 12,
                      "description": "Planned protection, alerts, and controls for the family."
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid filter value",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown endpoint",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "Method not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/health": {
      "get": {
        "operationId": "getHealth",
        "summary": "Check public API availability.",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "status"
                  ]
                },
                "example": {
                  "status": "ok"
                }
              }
            }
          },
          "404": {
            "description": "Unknown endpoint",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "Method not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  }
}
